post https://api.cashfree.com/verification/offline-aadhaar/verify
Use aadhar OTP verification API to verify aadhar by submitting the OTP received on your phone number and the reference ID received in the offline aadhar verification API response.
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 test data and response codes.
Sample Aadhaar Numbers
| Aadhaar Number | OTP | Remarks |
|---|---|---|
| 655675523712 | 111000 | Aadhaar Verification Successfull |
| 655675523712 | 000111 | OTP Invalid |
| 655675523712 | 000222 | Verification Failed |
| 655675523711 | 000113 | OTP Invalid |
| 655675523710 | 111000 | Invalid Aadhaar Number |
| 655675523709 | 111000 | Verification Failed |
Response Codes
| Sub Code | Status | Message | Next Action |
|---|---|---|---|
| 200 | SUCCESS | Aadhaar Card Exists | - |
| 400 | ERROR | OTP entered is invalid | Enter a valid OTP. |
| 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. |
Best Practices for Submitting OTP:
- Ensure you always submit the correct OTP.
- If the first Submit OTP API call fails for an Aadhaar due to the wrong OTP entered, wait for 50 seconds before resubmitting the correct OTP for the same Aadhaar.
- If verification fails for an Aadhaar on submitting the correct OTP, please generate a new OTP using the Generate OTP API for the same Aadhaar.
- The average response time is between 8 to 10 seconds.