Skip to main content

Tracking Verification Status

After creating a verification request, it’s important to track its status to understand where it is in the verification lifecycle. This guide explains the possible statuses and how to check them.

Verification Request Statuses

A verification request can have one of the following statuses:

Checking Verification Status

You can check the status of a verification request using our API.

API Endpoint

Request Parameters

Example Request

Handling Different Statuses

Pending

When a verification is in the pending status:
  • The user has not yet completed the verification process
  • You may want to display a message to the user or send a reminder

Verified

When a verification reaches the verified status:
  • The user has successfully completed verification
  • Your application can proceed with the protected action
  • This is the successful end state of the verification flow

Failed

When a verification has the failed status:
  • The verification attempt was unsuccessful
  • You may want to prompt the user to try again with a new verification request

Cancelled

When a verification is cancelled:
  • The verification request was stopped prematurely
  • This typically happens through admin action or system decision

Expired

When a verification has expired:
  • The verification request has exceeded its time limit
  • You should prompt the user to start a new verification process