Aadhaar OKYC Verify OTP(Coming Soon)

Aadhaar Verification is an important step in KYC. Businesses can automate Aadhaar verification using Sandbox API.

API Pricing Image

Overview

Verify the Aadhaar number by entering the OTP and ref_id received from Aadhaar OKYC Generate OTP API and receive the information pertaining to the individual.

Problem

  • After generating the OTP, the business will have to verify the OTP to get Aadhaar details for KYC purposes.
  • Companies have to ensure the correct individual is being onboarded.

Solution

  • NBFCs, banks, lending platforms, insurance companies, and even HRMS platforms can use these Aadhaar details for verifying the customer.
  • The process of verifying Aadhaar with consent is facilitated through the use of OTP.

Endpoint

HTTP MethodResource
POST/kyc/aadhaar/okyc/verify-otp

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass Aadhaar, consent & reason for verification

Body Parameters

ParamTypeDescriptionExample
ref_idstringReference ID received from Aadhaar OKYC Generate OTP API1234567
otpstringOne Time Password received on registered phone number999999

Sample CURL Request

curl --request POST \
     --url https://api.sandbox.co.in/kyc/aadhaar/okyc/verify-otp \
     --header 'Authorization: xxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
  "otp": "999999",
  "ref_id": "1234567"
}
'

❗️

Test Environment Not Available


Response

The response includes non-identifying public data as below

ParamTypeDescriptionExample
ref_idstringThe reference ID you have received in the Aadhaar generate OTP API1234567
statusstringAadhaar Exists or not possible values are:
VALID
INVALID
VALID
messagestringMessage for the status of APIAadhaar Card Exists
care_ofstringRelationship details of the Aadhaar Holder.S/O: Johnny Doe
dobstringDate of Birth of the Aadhaar Holder123456789012
emailstringHashed email of Aadhaar Holder044917e2c4c62a439d068.......d9f71bbde10b
genderstringGender of the Aadhaar HolderM
namestringName of the Aadhaar HolderJohn Doe
split_addressobjectSplit Address of the Aadhaar HolderLook Below
year_of_birthstringYear of Birth of Aadhaar Holder1985
mobile_hashstringHashed Mobile Number of Aadhaar Holder044917e2c4c62a439d068.......d9f71bbde10b1d227a914e
photo_linkstringHashed Photo Link of Aadhaar Holderdata:image/jpeg;base64,/9j/4AAQSk.......mj/2Q==

split_address entity

ParamTypeDescriptionExample
countrystringCountry of the Aadhaar HolderIndia
diststringDistrict of the Aadhaar HolderBengaluru
housestringHouse addressMangal Kanaka Niwas
landmarkstringLandmark address-
pincodestringPincode of the Aadhaar Holder581615
postringPost officeBengaluru
statestringState of the Aadhaar HolderKarnataka
streetstringStreet addressMain Cross 3rd
subdiststringSub District-
vtcstringVillage, Town, City(VTC)Bengaluru

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Aadhaar Verification is a Paid API, a wallet charge per API call will be applicable.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here