POST /v1/india/pan-aadhaar-link
Verify whether a PAN is linked to an Aadhaar number under Section 139AA of the Income Tax Act. Required for all financial onboarding in India since 1 July 2017.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization required | Bearer | Your API key · sandbox or live |
| Content-Type required | string | application/json |
| X-Idempotency-Key | string | Optional · prevent duplicate processing on retry |
Request body
| Field | Type | Description |
|---|---|---|
| pan required | string · 10 | PAN in format AAAPL1234C (5 letters · 4 digits · 1 letter) |
| aadhaar required | string · 12 | Aadhaar number · Verhoeff-validated |
Response
200 · OK
| Field | Type | Description |
|---|---|---|
| status | enum | linked · unlinked · not_found |
| pan | string | Echoed PAN |
| aadhaar_hash | string | SHA256 hash · first 16 chars · for de-dup without storing raw |
| mode | enum | LIVE · STUB (sandbox) |
| ref | string | Regulatory reference · e.g. 139AA · Income Tax Act |
400 · Bad Request
Invalid PAN format · invalid Aadhaar (Verhoeff fail) · missing required field
401 · Unauthorized
Missing or invalid API key
429 · Rate Limited
Exceeded plan TPS · retry after Retry-After seconds
Notes
- Sandbox returns deterministic STUB response · same input → same output · safe to test without UIDAI sub-AUA license
- Aadhaar number never stored · only SHA256 hash (16-char prefix) for de-dup
- Pricing: ₹1.50/call in sandbox free · ₹1.50 per successful call in production
- Mandatory: India Section 139AA from 1 July 2017 · operative for all NBFC/Bank onboarding