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
| Field | Type | Required | Description |
|---|---|---|---|
tan | string | Yes | Tax 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
| Field | Type | Description |
|---|---|---|
is_valid | string | Whether the TAN is valid. |
company_name | string | Name 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.