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"
}