Feel free to reach techsupport@surepass.io for any technical support or guidance.

Status

Production

https://kyc-api.surepass.app

GET

/api/v1/aadhaar-v4/status

Check the status of an OVSE verification session.

Poll this endpoint after initialization to track verification progress. Only returns sessions belonging to the authenticated user.

Possible statuses:

pending — Waiting for user to complete verification

callback_received — Callback received, processing credentials

completed — Verification completed successfully

failed — Verification failed

expired — Session expired

Request

Query Params

Responses

🟢200OK

application/json

Status retrieved successfully

Body

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://kyc-api.surepass.app/api/v1/aadhaar-v4/status?client_id=aadhaar_ovse_abc123'

Response Example

{
    "data": {
        "client_id": "aadhaar_ovse_abc123",
        "status": "pending",
        "status_description": "Waiting for user to complete verification via mAadhaar app."
    },
    "status_code": 200,
    "message": "Success",
    "success": true
}

Initialize

Result