Sign in

v1

latestOpenAPI 3.0.32026-07-14108241269.2 KB
PAN Verification

PAN Verification

Verifies a PAN number. Requires X-API-KEY and X-Client-ID headers.

post/verify/pan_nsdl

Request body

pan_numberstring required

PAN number (10 chars). Pattern: 5 letters, 4 digits, 1 letter.

namestring

Name as provided by the user

dobstring date

Date of birth (YYYY-MM-DD)

Example request

{
  "pan_number": "ABCDE1234F",
  "name": "Amit Verma",
  "dob": "1990-05-21"
}

Response

PAN lookup successful

panstring

Queried PAN (masked or synthetic in examples)

name_inputstring

Name provided in the request

dob_inputstring date

DOB provided in the request

pan_statusstring

PAN existence/status code (provider-specific). Example: 'E' = exists

name_matchboolean

Whether the provided name matches the PAN record

dob_matchboolean

Whether the provided DOB matches the PAN record

pan_typestring nullable

PAN classification/type when available

aadhaar_seedingboolean

Whether Aadhaar is seeded/linked to this PAN

aadhaar_seeding_descriptionstring

Human readable description about Aadhaar seeding

statusstring required

Overall API response status

messagestring

Informational message from the provider

timestampinteger

Unix epoch timestamp of the response

chargeblestring

Indicates if the operation is chargeable ('true'|'false')

user_consentstring

Indicates if user consent was obtained ('true'|'false')

Example response

{
  "pan": "ABCDE1234F",
  "name_input": "Amit Verma",
  "dob_input": "1990-05-21",
  "pan_status": "E",
  "name_match": true,
  "dob_match": true,
  "aadhaar_seeding": true,
  "aadhaar_seeding_description": "Aadhaar is linked to PAN",
  "status": "success",
  "message": "PAN verification successful",
  "timestamp": 1700000000,
  "chargeble": "true",
  "user_consent": "true"
}