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.


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 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.
401ERRORInvalid clientId and clientSecret combinationEnter the client ID and client secret key in the API.
403ERRORIP not whitelistedWhitelist the IP address.
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.


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.