PAN comprehensive API reference

PAN comprehensive

Verifies a PAN with the issuing source and returns name, status and linked details.

Endpoint

POST https://api.finovel.in/v1/pan-comprehensive

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	PAN
`get_address`	checkbox	No	Include address
`get_contact`	checkbox	No	Include contact

Example request

curl -X POST https://api.finovel.in/v1/pan-comprehensive \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"id_number":"ABCDE1234F","get_address":true,"get_contact":false}'

Response fields

Inside data:

Field	Description
`pan_number`	PAN
`full_name`	Full name
`status`	Status
`category`	Category
`aadhaar_linked`	Aadhaar linked
`masked_aadhaar`	Masked Aadhaar
`dob`	Date of birth
`address.city`	City

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "dob": "1990-01-01",
    "gender": "M",
    "status": "valid",
    "address": {
      "zip": "560001",
      "city": "Bengaluru",
      "state": "Karnataka",
      "line_1": "1 Test Street",
      "country": "IN"
    },
    "category": "person",
    "client_id": "pan_comprehensive_sandbox",
    "full_name": "SANDBOX TEST USER",
    "pan_number": "ABCDE1234F",
    "dob_verified": true,
    "aadhaar_linked": true,
    "masked_aadhaar": "XXXXXXXX1234"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

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