Aadhaar Verification via OCR

curl --request POST \
  --url https://sandbox.cashfree.com/verification/document/aadhaar \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --form verification_id=12345678 \
  --form back_image=BACK_IMAGE \
  --form front_image=FRONT_IMAGE

{
  "uid": "XXXX-XXXX-3717",
  "name": "Varun Bhupati",
  "yob": "1997",
  "pincode": "474009",
  "address": "S / O : Mahesh Bhupati, 202-parivar daser complex , dal  bazar , Gird , Gwalior , Lashkar City , Madhya Pradesh , 474019",
  "state": " Madhya Pradesh",
  "gender": "Male",
  "father": "Mahesh Bhupati",
  "valid": true,
  "status": "VALID",
  "verification_id": "19bf45c0-8149-4d3f-8d98-c004c4037eba",
  "reference_id": "2345",
  "confidence_score": "",
  "message": "Aadhaar card is valid"
}

Aadhaar Verification via OCR

Use this API to extract the details of a customer from the respective aadhaar card image and return it to the business for verification or for KYC requirements. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Response Codes

Sub Code	Status	Message	Next Action
200	SUCCESS	Aadhaar card is valid	-
200	SUCCESS	Aadhaar card is invalid	Upload a valid aadhaar copy.
400	ERROR	file size exceeded	The max file size of both the files is 10MB.
400	ERROR	please upload the file of valid format(jpeg/jpg/png)	Allowed file type - JPEG/JPG/PNG.
400	ERROR	verification_id is missing in the request.	Enter a unique verification ID in the request.
400	ERROR	Front Image File is missing	Upload the scanned image of the front of the aadhaar card.
400	ERROR	verification_id can include a maximum of 50 characters.	Enter a unique verification ID within 50 characters.
400	ERROR	Client secret belongs to test environment	Enter the correct environment credentials in the request.
400	ERROR	verification_id can include only alphanum, dot, hyphen and underscores.	Only alphanumeric, hyphen (-), period (.), and underscore ( _ ) are allowed.
400	ERROR	x-client-id is missing in the request	Enter all the header information in the API request.
401	ERROR	Invalid clientId and clientSecret combination	Enter valid client ID and secret key in the request.
403	ERROR	IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://www.cashfree.com/docs/secure-id/get-started/integration/ip-whitelisting-verification	Whitelist the IP address.
422	ERROR	Insufficient balance to process this request.	Ensure you have sufficient balance and then process the request.
500	ERROR	something went wrong	Try after some time.

POST

document

aadhaar

Aadhaar Verification via OCR

curl --request POST \
  --url https://sandbox.cashfree.com/verification/document/aadhaar \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --form verification_id=12345678 \
  --form back_image=BACK_IMAGE \
  --form front_image=FRONT_IMAGE

{
  "uid": "XXXX-XXXX-3717",
  "name": "Varun Bhupati",
  "yob": "1997",
  "pincode": "474009",
  "address": "S / O : Mahesh Bhupati, 202-parivar daser complex , dal  bazar , Gird , Gwalior , Lashkar City , Madhya Pradesh , 474019",
  "state": " Madhya Pradesh",
  "gender": "Male",
  "father": "Mahesh Bhupati",
  "valid": true,
  "status": "VALID",
  "verification_id": "19bf45c0-8149-4d3f-8d98-c004c4037eba",
  "reference_id": "2345",
  "confidence_score": "",
  "message": "Aadhaar card is valid"
}

Authorizations

x-client-id

string

header

required

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret

string

header

required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

x-api-version

string

It is the API version. To receive the aadhaar seeding status in the response, use any date after 2022-09-12

x-cf-signature

string

Send the signature if IP is not whitelisted

Body

multipart/form-data

Find the request parameters to extract the details of a customer from the aadhaar card image

Request body schema for Aadhaar Verification via OCR.

Response

200

application/json

Success response for verifying aadhaar information

Success response for Aadhaar Verification via OCR

Secure ID APIs

V2

V1

Aadhaar Verification via OCR

Response Codes

Authorizations

Headers

Body

Response