POST
/v1/business/tin- Authentication
- Bearer token
- Scope
kyc:verify
Before you integrate
- result is a list, not an object; the field names above are for each item in it.
Request body
| Field | Type | Required | Description |
|---|---|---|---|
tin | string | Yes | Eleven-digit state TIN. Spaces and hyphens 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/tin' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tin": "27290123456"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": [
{
"dealer": "EXAMPLE TRADERS",
"owner_name": "ASHA RAO",
"pan": "ABCDE1234F",
"status": "Active",
"registration_status": "Registered",
"cst_status": "Registered",
"reg_date": "2015-04-01",
"cancel_date": "",
"address": "12 Example Lane, Pune, Maharashtra, 411001",
"split_address": {
"district": [
"Pune"
],
"state": [
"Maharashtra"
],
"city": [
"Pune"
],
"pincode": "411001",
"country": [
"India"
],
"address_line": "12 Example Lane"
}
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
[] | array | One entry per dealer registration found for the TIN. |
[].dealer | string | Name of the dealer. |
[].owner_name | string | Name of the owner. |
[].pan | string | PAN on the registration. |
[].status | string | Status of the registration. |
[].registration_status | string | Registration status. |
[].cst_status | string | Central sales tax registration status. |
[].reg_date | string | Date of registration. |
[].cancel_date | string | Date of cancellation, if cancelled. |
[].address | string | Address of the dealer. |
[].split_address | object | The dealer's address broken into parts. |
[].split_address.district | array | District name, as a list. |
[].split_address.state | array | State name, as a list. |
[].split_address.city | array | City name, as a list. |
[].split_address.pincode | string | Six-digit pincode. |
[].split_address.country | array | Country name, as a list. |
[].split_address.address_line | string | Street-level part of the address. |
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.