Validate Token

Validate Token

To verify a sent verification token, follow these steps:

  • Send the verification code provided by your user along with the corresponding id from the initial Verify request.
  • Check the status of the response to verify if the code provided by the user matches the one sent by CPaaS Alerts.

This process can only be performed once for each token, ensuring the integrity of the verification system.

API Endpoint

https://eu.cpaas.bics.com/api/v2/

Note: Few elements in the endpoint may change from service to service.

GET

{endpoint}verify/check/{id}/{token}

MANDATORY PARAMETERS

Name Type Description
id string This is the id you received in the response to the Verify request.
token int The verification code entered by your user.

Example Request

cURL - cURL
curl --location --globoff '{endpoint}api/v2/verify/check/{otp_id}/{token}'

Example Response

{
  "id": "41379328-d3a7-4fcd-be90-d5237f911d76",
  "status": "success"
}

SUCCESS CODES

Code Status Status Description
200 success Verified successfully.

FAILURE CODES

Code Status Status Description
401 Unauthenticated Authentication Error
200 failed when you passed invalid id value
200 expired token expired
200 invalid when you passed wrong token for verification
200 OTP already verified when you already verified the OTP