Aadhaar validation API reference

Aadhaar validation

Validates an Aadhaar number and returns age band, state, gender and mobile-linked status.

Endpoint

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

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
`id_number`	text	Yes	Aadhaar number

Example request

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

Response fields

Inside data:

Field	Description
`age_range`	Age range
`state`	State
`gender`	Gender
`is_mobile`	Mobile linked
`last_digits`	Mobile last digits

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "state": "Karnataka",
    "gender": "M",
    "age_range": "30-40",
    "client_id": "aadhaar_validation_sandbox",
    "is_mobile": true,
    "less_info": false,
    "last_digits": "210",
    "aadhaar_number": "XXXXXXXX0124"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

Not found (contains 0000)
Provider error (contains 9999)
Valid Aadhaar (default)