PAN Validation v2

Validate PAN details

This API verifies the basic details associated with a PAN card by validating the PAN number and the cardholder's name. It retrieves the registered name directly from the official PAN database maintained by the government. If the provided PAN number exists in the underlying registry, the API returns the Status of PAN (Active/Invalid).

post/v2/verify/pan_validation

Request

  • Base URL
    https://prod.idto.ai
  • URL
    https://prod.idto.ai/v2/verify/pan_validation
  • Auth
    API key in header X-Client-ID and API key in header X-API-KEY

Request body

pan_numberstring required

PAN to verify. Must follow the 10-character PAN format (five letters, four digits, one letter). Example: ACGPA1234K

user_consentboolean required

User consent flag required by the v2 PAN flow.

Response

PAN verification result. Raw vendor audit payloads are stored internally and are not included in the response body.

status'success' | 'failed' required

Top-level verification status. 'success' for a verified PAN (HTTP 200), 'failed' for a valid request with no matching record (HTTP 200).

messagestring required

Human-readable message. Always present.

error_codestring nullable required

Canonical IDTO error code. Always present; null on success.

tranx_idstring nullable

Internal transaction identifier.

timestampstring nullable

Creation timestamp in ISO 8601 format.

Changes

No recorded changes to this operation across all 1 revision of this API.