Aadhaar Secure QR API reference

Aadhaar Secure QR

Decodes the Secure QR on an Aadhaar card or e-Aadhaar and checks the UIDAI signature.

Endpoint

POST https://api.finovel.in/v1/aadhaar-qr

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

Field	Type	Required	Description
`document`	file	Yes	Aadhaar photo or PDF
`pdf_password`	text	No	PDF password. Only for a password-protected PDF.

Example request

curl -X POST https://api.finovel.in/v1/aadhaar-qr \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{}'

Response fields

Inside data:

Field	Description
`name`	Name
`dateOfBirth`	Date of birth
`gender`	Gender
`aadhaarLast4`	Aadhaar last 4
`address.formattedAddress`	Address
`signature.status`	UIDAI signature

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "name": "SANDBOX TEST USER",
    "gender": "M",
    "address": {
      "formattedAddress": "Bengaluru, Karnataka"
    },
    "signature": {
      "status": "VALID"
    },
    "dateOfBirth": "1990-01-01",
    "aadhaarLast4": "0124"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

QR decoded (default)