Checking a token's status
GET /check_token_status
Description​
The /check_token_status endpoint serves to retrieve the current status of a given token. You need to pass the token as a query parameter. Simply include token=your_token in the request to specify the token whom's status you want to check.
Below are the available statuses for a token:
"Pending Token": This status indicates that a verification has not yet been initiated using the provided token. The verification process is yet to begin, and you can expect further updates on the token's progress."Token has already been used": This status indicates that a verification has already been performed using the provided token. The token has been utilized for a verification process, and the associated results may be available for review."Invalid Token": This status indicates that the token provided is invalid or does not exist within the system. Please ensure the correctness of the token and try again with a valid token.
Remember to inlcude the X-API-AUTH header to your requests.API Authentication
- Example Request
- Example Response
curl --location 'https://service-prod.metric.africa/api/identification/check_token_status?token=XXXXXXX' \
--header 'X-API-AUTH: abcdefghijklmnopqrstuvwxyz'
HTTP/1.1 200 OK
Content-Type: application/json
{
"responsemessage": "Token has already been used"
}