post https://api.cashfree.com/verification/document/aadhaar
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.
Verify Aadhaar for Free!
You can verify your beneficiary Aadhaar details for free using Free Credits. With this limited-time offer, experience and test the feature without paying any verification charges.
A banner displays the offer for you on the Verification Suite - OKYC page (Verification Suite Dashboard > Verification Suite - OKYC). Click Claim Free Credits and instantly redeem the credits to your account.
Click here to view the response codes.
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | OK | Aadhaar card is valid | - |
| 200 | OK | Aadhaar card is invalid | Enter a valid aadhaar card number. |
| 400 | ERROR | File size exceeded 10MB limit | Upload a file that does not exceed 10MB. |
| 400 | ERROR | please upload the file of valid format(jpeg/jpg/png) | Upload the file in either JPEG, JPG, or PNG. |
| 400 | ERROR | verification_id is missing in the request. | Enter the verification ID. |
| 400 | ERROR | Front Image File is missing | Upload the front image. |
| 400 | ERROR | Back Image File is missing | Upload the back image. |
| 400 | ERROR | verification_id can include a maximum of 50 characters.. | Enter a verification ID within 50 characters. |
| 400 | ERROR | verification_id can include only alphanum, dot, hyphen and underscores. | Enter a verification ID that contains only alphanumeric values, period (.), hyphen (-), and underscore (_). |
| 400 | ERROR | x-client-id is missing in the request. | Provide the client ID in the request |
| 400 | ERROR | Please enter the otp in the request | Enter a valid OTP. |
| 400 | ERROR | Please enter a valid otp. | Enter a valid OTP. |
| 401 | ERROR | Invalid clientId and clientSecret combination | Enter the client ID and client secret key in the API. |
| 403 | ERROR | IP not whitelisted | Whitelist the IP address. |
| 422 | ERROR | Insufficient balance to process this request | Add sufficient balance and try again. |
| 500 | ERROR | Unable to validate, please retry later | Please try after some time. |
| 500 | ERROR | something went wrong, please try after some time | Please try after some time. |
Note:
Aadhaar verification via OCR is supported only for Aadhaar PVC card images.