Verify Candidate number Endpoint
Endpoint
URL: /api/verify-edu
Methods: POST
Description
This API endpoint allows users to verify jamb candidate number.
Authentication
To access this endpoint, users must include their API key and secret key in the request headers.
Request Headers
- api-key (string, required): The API key of the user.
- secret-key (string, required): The secret key of the user.
Request Body (POST)
- number (string, required): The registration number of the candidate.
- firstLevel (string, required): The name of the exam.
Usage Example
See usage example in the code snippets below:
Example: Verify candidate number
POST request to verify smart card number:
Content-Type: application/json
api-key: your-api-key
secret-key: your-secret-key
{
"number": "0000000000",
"firstLevel": "JAMB",
}
Response:
- Status Code: 200
{
"message": {
"Customer_Name": "IAB CODES LTD",
}
}
Failed Response Format
{
"error": "Please check the number and try again"
}
Other Error Responses
- 401 Unauthorized: Invalid API key or secret key.
- 404 Not Found: User not found or data not available.
- 500 Internal Server Error: Internal server error occurred.