API reference / Business / KYB

TAN verification

Deductor details for a tax deduction account number (TAN).

POST/v1/business/tan
Authentication
Bearer token
Scope
kyc:verify

Request body

FieldTypeRequiredDescription
tanstringYesTax deduction account number: four letters, five digits, one letter, for example HYDD01234A. Case and spaces are ignored.

Sample code

Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.

curl -sS -X POST 'https://grappi.ai/v1/business/tan' \
  -H "Authorization: Bearer $GRAPPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "tan": "HYDD01234A"
}'

Sample response

{
  "request_id": "req_01HZY3K8M2",
  "result": {
    "is_valid": "true",
    "company_name": "EXAMPLE TRADERS"
  }
}

Response fields

FieldTypeDescription
is_validstringWhether the TAN is valid.
company_namestringName of the deductor registered against the TAN.

Errors

Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.