PAN Aadhaar Link Status

API verifies the PAN Aadhaar Link for a user.

POST /kyc/pan-aadhaar/status

cURL

200 - Success

curl --request POST \
  --url https://test-api.sandbox.co.in/kyc/pan-aadhaar/status \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.kyc.pan_aadhaar.status",
  "pan": "XXXPX1234A",
  "aadhaar_number": "123456789012",
  "consent": "y",
  "reason": "For Testing"
}
'

200

200 - Success

{
  "code": 200,
  "timestamp": 1000000000000,
  "transaction_id": "de97e30a-2043-4ab0-84ff-0fbba3434a8f",
  "data": {
    "@entity": "in.co.sandbox.kyc.pan_aadhaar.status.response",
    "aadhaar_seeding_status": "y",
    "message": "Your PAN is linked to Aadhaar Number  XXXX XXXX 9999."
  }
}

Run in Postman

Headers

Authorization · string · required

JWT access token. For token-generation steps, refer to the Quickstart Guide.

x-api-key · string · required

API key used to identify and authenticate the client.

x-api-version · string

Specifies the API version for the request.

Content-Type · enum<string>

Media type of the request body.

Available options: application/json

Body

application/json

@entity · enum<string> · required

Available options: in.co.sandbox.kyc.pan_aadhaar.status

pan · string · required

Permanent Account Number to be verified against Aadhaar linkage records.

Pattern: ^[A-Z]{5}[0-9]{4}[A-Z]{1}$

aadhaar_number · string · required

12-digit Aadhaar number of the PAN holder used to validate PAN–Aadhaar linkage.

Pattern: ^[0-9]{12}$

consent · enum<string> · required

Explicit consent from the end user to retrieve and verify PAN and Aadhaar linkage information.

Available options: Y, y

reason · string · required

Purpose for requesting PAN–Aadhaar verification.

Minimum string length: 20

Response

200

application/json

code · integer · required

timestamp · integer · required

transaction_id · string · required

data · object · required

Show child attributes