post https://api.cashfree.com/verification/offline-aadhaar/otp
Use aadhar OTP verification API to generate OTP for a given aadhar number and it will be sent to the mobile number linked with the aadhar.
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 | OTP sent successfully | - |
| 200 | SUCCESS | Invalid Aadhaar Card | Enter a valid aadhaar card number. |
| 200 | SUCCESS | Aadhaar not linked to mobile number | - |
| 200 | SUCCESS | Aadhaar number does not have mobile number | Link aadhaar number with your customer's phone number. |
| 400 | ERROR | Aadhaar Number should contain 12 characters. | Enter the 12 digit aadhaar number. |
| 400 | ERROR | Please enter aadhaar number in numeric format | Aadhaar number should contain only numeric values. |
| 400 | ERROR | Please enter aadhaar number in the request | Enter aadhaar number in the API request. |
| 400 | ERROR | x-client-id is missing in the request. | Ensure x-client-id is entered in the API request. |
| 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. |
| 409 | ERROR | Otp generated for this aadhaar, please try after some time | An OTP is already generated for the aadhaar number. Retry after 30 seconds. |
| 422 | ERROR | Insufficient balance to process this request | Add sufficient balance and try again. |
| 500 | ERROR | Unable to validate, please retry later | Try again after some time. |
| 500 | ERROR | Something went wrong, please try after some time | Try again after some time. |
Best Practices for Generating OTP
- Please wait for 30 seconds before generating a new OTP for the same Aadhaar using the Generate OTP to Verify Aadhaar API.
- The average response time is between 4 to 5 seconds.
- OTP generated is valid for 10 minutes only.
You can claim free credits to verify your beneficiary details.