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:
StatusDescription
pendingThe verification request has been created but not yet completed by the user
verifiedThe user has successfully completed the verification process
failedThe verification attempt was unsuccessful (e.g., wrong OTP entered too many times)
cancelledThe verification request was cancelled by the system or an administrator
expiredThe verification request has expired (time limit exceeded)

​
Checking Verification Status

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

​
API Endpoint

GET https://api.scute.io/v1/verify/:app_id/verifications/:id

​
Request Parameters

ParameterTypeDescription
app_idstringYour Scute application ID (in the URL path)
idstringThe ID of the verification request to check

​
Example Request

// Using fetch
const response = await fetch('https://api.scute.io/v1/verify/your-app-id/verifications/verification-id', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_SCUTE_API_KEY'
  }
});

const data = await response.json();
console.log(data.status); // Will show one of: pending, verified, failed, cancelled, expired

​
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