POSTPAN Advanced

Rich PAN verification returning registered name, PAN type, gender, DOB, masked Aadhaar, address, email, and mobile.

POST/tools/kyc/pan-advanced

PAN Advanced performs a deeper KYC lookup against the PAN database. In addition to the match flags returned by PAN Lite, it surfaces the registered name, name on the PAN card, PAN type (Individual / Company / etc.), gender, date of birth, masked Aadhaar number, Aadhaar link status, and structured address. Email and mobile fields are populated at a ~5–10% fill rate due to data-source availability. Use this API when downstream workflows need authoritative identity attributes beyond a pass/fail match.

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`client_ref_id`	string	optional	Unique reference id per API call, generated by your system.e.g. REQ-20260101-001
`pan`PAN Number	string	required	10-character alphanumeric PAN identifier (first 5 alphabets, 4 digits, 1 alphabet).e.g. ABCDE1234F
`name`	string	required	Individual's name per PAN information, used for match scoring.e.g. Rajesh Kumar
`dob`Date of Birth	string	required	Date of birth in YYYY-MM-DD format.e.g. 1994-08-29

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

client_ref_idstringoptional

Unique reference id per API call, generated by your system.

example: REQ-20260101-001

panstringRequired· PAN Number

10-character alphanumeric PAN identifier (first 5 alphabets, 4 digits, 1 alphabet).

example: ABCDE1234F

namestringRequired

Individual's name per PAN information, used for match scoring.

example: Rajesh Kumar

dobstringRequired· Date of Birth

Date of birth in YYYY-MM-DD format.

example: 1994-08-29

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- panstring
  PAN number submitted in the request.
- name_providedstring
  Name as submitted in the request.
- registered_namestring
  Authoritative name registered in the PAN database.
- name_pan_cardstring
  Name printed on the physical PAN card.
- first_namestring
  First name parsed from the PAN record.
- last_namestring
  Last name parsed from the PAN record.
- typestring
  PAN holder category (e.g., 'Individual', 'Company', 'Firm', 'Trust', 'HUF').
- genderstring
  Gender from PAN record. Values: 'M' (Male), 'F' (Female).
- date_of_birthstring
  Date of birth from the PAN record (YYYY-MM-DD).
- masked_aadhaar_numberstring
  Aadhaar number with first 8 digits masked for privacy (e.g., 'XXXX XXXX 1234').
- aadhaar_linkedboolean
  Whether the PAN is linked to an Aadhaar number.
- emailstring
  Email address associated with the PAN. Fill rate is approximately 5–10% due to data-source availability.
- mobile_numberstring
  Mobile number associated with the PAN. Fill rate is approximately 5–10% due to data-source availability.
- addressobject
  Structured address fields of the PAN holder.
  - full_addressstring
    Complete address string.
  - streetstring
    Street name / house number.
  - citystring
    City name.
  - statestring
    State name.
  - pincodenumber
    6-digit postal PIN code.
  - countrystring
    Country name.