GETCheck Bulk PAN Verification Status

Poll the result of a Bulk PAN Verification batch using the reference_id returned when the batch was submitted.

GET/tools/kyc/pan/bulk/status

Retrieves the per-PAN results for a batch previously submitted via the Bulk PAN Verification API. Because bulk verification runs asynchronously, callers poll this endpoint with the reference_id from the submit response until the batch finishes processing. The response returns a count and an array of entries, one per PAN, each carrying the validity, registered name, name-match score/result, Aadhaar-seeding status, and PAN status.

Request

Query parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`client_ref_id`	string	optional	Unique reference ID per API call, generated by your system (max 20 characters).e.g. 2026010100123456789
`reference_id`	string	required	Unique id returned by the Bulk PAN Verification API for the submitted batch.e.g. 123456
`bulk_reference_id`	string	optional	Unique id created to identify the bulk request, if you tracked one at submit time.e.g. BULK-PAN-20240101-001

initiator_idstringRequired

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

example: 9962981729

client_ref_idstringoptional

Unique reference ID per API call, generated by your system (max 20 characters).

example: 2026010100123456789

reference_idstringRequired

Unique id returned by the Bulk PAN Verification API for the submitted batch.

example: 123456

bulk_reference_idstringoptional

Unique id created to identify the bulk request, if you tracked one at submit time.

example: BULK-PAN-20240101-001

These headers authenticate and sign every request. See How Auth Works for details.

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.
- countnumber
  Number of entries in the results array.
- entriesarray
  Per-PAN verification results for the batch.
  - panstring
    10-character PAN identifier.
  - validstring
    PAN card validity status.
  - registered_namestring
    Name on record against the PAN.
  - name_providedstring
    Name submitted in the bulk request for this PAN.
  - name_match_scorestring
    Name verification score.
  - name_match_resultstring
    Name match result.
  - aadhaar_seeding_statusstring
    Aadhaar-PAN linkage status.
  - pan_statusstring
    Current PAN status.
  - messagestring
    Success or failure details for this entry.
  - reference_idstring
    Unique reference identifier for the entry.
  - last_updated_atstring
    Timestamp when the entry was last updated.

GETCheck Bulk PAN Verification Status

Request

Query parameters

Responses

Next steps

Related