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.