Submit OTP for Aadhaar Verification

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.

Click here to view the test data and response codes.

Sample Aadhaar Numbers

Aadhaar NumberOTPRemarks
655675523712111000Aadhaar Verification Successfull
655675523712000111OTP Invalid
655675523712000222Verification Failed
655675523711000113OTP Invalid
655675523710111000Invalid Aadhaar Number
655675523709111000Verification Failed

Response Codes

Sub CodeStatusMessageNext Action
200SUCCESSAadhaar Card Exists-
400ERROROTP entered is invalidEnter a valid OTP.
400ERRORx-client-id is missing in the request.Provide the client ID in the request
400ERRORPlease enter the otp in the requestEnter a valid OTP.
400ERRORPlease enter a valid otp.Enter a valid OTP.
400ERRORPlease enter a valid ref_idEnter a valid reference ID.
400ERROROTP entered is invalidEnter a valid OTP.
400ERROROtp expiredGenerate a new OTP and submit before the OTP expires.
400ERRORSession expired, please generate a new OTPGenerate a new OTP and submit before the session expires.
400ERRORx-client-id is missing in the request.Ensure x-client-id is entered in the API request.
400ERRORInvalid Aadhaar CardEnter a valid aadhaar number.
400ERRORAadhaar not linked to mobile numberEnter a valid aadhaar number linked to the entered mobile number.
401ERRORInvalid clientId and clientSecret combinationEnter the client ID and client secret key in the API.
403ERRORIP not whitelistedWhitelist the IP address.
409ERROROtp generated for this aadhaar, please try after some timeGenerate a new OTP after 45 seconds.
422ERRORInsufficient balance to process this requestAdd sufficient balance and try again.
500ERRORUnable to validate, please retry laterPlease try after some time.
500ERRORsomething went wrong, please try after some timePlease try after some time.

You can claim free credits to verify your beneficiary details.


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.