ID number check API reference

ID number check

Format and check-digit validation for Aadhaar, PAN, GSTIN, TAN, CIN, Udyam and IFSC.

Endpoint

POST https://api.finovel.in/v1/id-number-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
`id_type`	select	Yes	ID type One of: AADHAAR, PAN, GSTIN, TAN, CIN, UDYAM, IFSC.
`number`	text	Yes	Number

Example request

curl -X POST https://api.finovel.in/v1/id-number-check \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"id_type":"GSTIN","number":"27AAPFU0939F1ZV"}'

Response fields

Inside data:

Field	Description
`valid`	Valid
`valid_format`	Valid format
`checksum_valid`	Check digit valid
`details.holder_type`	Holder type
`details.state`	State
`details.pan`	Embedded PAN
`details.company_type`	Company type
`details.bank_code`	Bank code

Example response from the sandbox

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