PAN format check API reference

PAN format check

Checks that a PAN is well formed and reads the holder type. Instant.

Endpoint

POST https://api.finovel.in/v1/pan-format-check

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

Field	Type	Required	Description
`pan`	text	Yes	PAN

Example request

curl -X POST https://api.finovel.in/v1/pan-format-check \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"pan":"ABCPE1234F"}'

Response fields

Inside data:

Field	Description
`pan`	PAN
`valid_format`	Valid format
`holder_type`	Holder type
`holder_type_code`	Holder type code

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": null,
  "error": null,
  "charged_paise": 0
}