Skip to main content
POST
/
offline-aadhaar
/
verify
Submit OTP to Verify Aadhaar
curl --request POST \
  --url https://sandbox.cashfree.com/verification/offline-aadhaar/verify \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "otp": "267987",
  "ref_id": "21637861"
}'
{
  "ref_id": "70471",
  "status": "VALID",
  "message": "Aadhaar Card Exists",
  "care_of": "S/O: Fakkirappa Dollin",
  "address": "Shri Kanaka Nilaya,,Umashankar Nagar 1st Main 5th Cross,Ranebennur,Haveri-Karnataka,India",
  "dob": "02-02-1995",
  "email": "",
  "gender": "M",
  "name": "Mallesh Fakkirappa Dollin",
  "split_address": {
    "country": "India",
    "dist": "Haveri",
    "house": "Shri Kanaka Nilaya",
    "landmark": "",
    "pincode": 581115,
    "po": "Ranebennur",
    "state": "Karnataka",
    "street": "Umashankar Nagar 1st Main 5th Cross",
    "subdist": "Ranibennur",
    "vtc": "Ranibennur",
    "locality": "Pritam Pura"
  },
  "year_of_birth": 1995,
  "mobile_hash": "ed189eb73247cb90b769e7e8d7dfd2efa4cd6a5ec27602f5d2721c035266568c",
  "photo_link": "<base64 encoded image>",
  "share_code": "1234",
  "xml_file": "<xml file link with 48hrs expiry>"
}

Authorizations

ā€‹
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

ā€‹
x-client-secret
string
header
required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

ā€‹
x-cf-signature
string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters to submit the generated OTP

ā€‹
otp
string
default:267987
required

It is the OTP received on the registered phone number for offline aadhaar verification.

Example:

"267987"

ā€‹
ref_id
string
default:21637861
required

It is the unique ID created by Cashfree Payments that you receive in the response of Generate OTP to Verify Aadhaar API.

Example:

"21637861"

Response

Success response for submitting the generated OTP for offline aadhaar verification

ā€‹
ref_id
string

It displays the unique ID created by Cashfree Payments for reference purposes.

Example:

"123456789"

ā€‹
status
string

It displays the status of the aadhaar information. Possible values are:

  • VALID: Successfully fetched Aadhaar details.
Example:

"VALID"

ā€‹
message
string

It displays details about the success or failure of the API request.

Example:

"123456789"

ā€‹
care_of
string

It displays the parent/guardian of the aadhaar card holder.

Example:

"Jane Doe"

ā€‹
address
string

It displays the address information as present in the aadhaar card.

Example:

"Chimli"

ā€‹
dob
string

It displays the date of birth of the aadhaar card holder.

Example:

"01-01-2000."

ā€‹
email
string

It displays the email hash of the aadhaar card holder.

Example:

"v5c64757c746ytvfb687iyjg"

ā€‹
gender
string

It displays the gender of the aadhaar card holder.

Example:

"Male"

ā€‹
name
string

It displays the name of the aadhaar card holder.

Example:

"John Doe"

ā€‹
year_of_birth
string

It displays the year of birth of the aadhaar card holder.

Example:

"2000"

ā€‹
mobile_hash
string

It displays the unique information about the device's hardware, software, and other characteristics.

Example:

"v5c64757c746ytvfb687iyjg"

ā€‹
photo_link
string

It displays the base64-encoded image present on the Aadhaar card.

Example:

"IMAGE_LINK"

ā€‹
share_code
string

It is the passcode with which we can unzip the xml file

Example:

1234

ā€‹
xml_file
string

It is the link which points to the zip file and contains the xml file and has 24 hrs expiry

Example:

"https://abc.xyz"

ā€‹
split_address
object

It contains the address information in individual components.