Verify Aadhaar OTP

Verify the Aadhaar number by passing the OTP received on the individual’s registered mobile number.

POST /kyc/aadhaar/okyc/otp/verify

Aadhaar Offline e-KYC Verify OTP

cURL

curl --request POST \
  --url https://api.sandbox.co.in/kyc/aadhaar/okyc/otp/verify \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.kyc.aadhaar.okyc.request",
  "reference_id": "9020131",
  "otp": "361679"
}
'

200

Success

{ "code": 200, "timestamp": 1769090090000, "transaction_id": "439d3c58-e97b-46c3-bb85-4b113be87451", "data": { "@entity": "in.co.sandbox.kyc.aadhaar.okyc", "reference_id": 1234567, "status": "VALID", "message": "Aadhaar Card Exists", "care_of": "S/O: Johnny Doe", "full_address": "Mangal Kanaka Niwas, Main Cross 3rd, Bengaluru, Bengaluru-Karnataka, India ", "date_of_birth": "21-04-1985", "email_hash": "044917e2c4c62a439d068.......d9f71bbde10b1d227a914e", "gender": "M", "name": "John Doe", "address": { "@entity": "in.co.sandbox.kyc.aadhaar.okyc.address", "country": "India", "district": "Bengaluru", "house": "Mangal Kanaka Niwas", "landmark": "", "pincode": "581615", "post_office": "Bengaluru", "state": "Karnataka", "street": "Main Cross 3rd", "subdistrict": "", "vtc": "Bengaluru" }, "year_of_birth": "1985", "mobile_hash": "044917e2c4c62a439d068.......d9f71bbde10b1d227a914e", "photo": "data:image/jpeg;base64,/9j/4AAQSk.......mj/2Q==", "share_code": "1234" } }

Run in Postman

Headers

x-api-key · string · required

API key for identification

Authorization · string · required

JWT access token

x-api-version · string

Body

application/json

@entity · string · required

Allowed value: "in.co.sandbox.kyc.aadhaar.okyc.request"

reference_id · string · required

Unique reference identifier returned by the Generate OTP API for this Aadhaar verification flow. Used to correlate the OTP submission with the original request.

otp · string · required

6-digit one-time password sent to the mobile number linked with the Aadhaar. Must be entered exactly as received and is valid only for the associated reference_id.

Required string length: 6

Pattern: ^[0-9]{6}$

Response

200

application/json

code · integer · required

timestamp · integer · required

transaction_id · string · required

data · object · required

Show child attributes