KwikID DocumentationTIN Fetch
Fetches TIN (Taxpayer Identification Number) registration details via KwikID.
TIN Fetch
API reference
Try itLoading playground…
Loading…
AuthorizationBearer <token>
JWT Bearer token authentication. Obtain a token from the KwikID dashboard.
In: header
tinNumberstring
The TIN number to look up.
clientData?object
Custom metadata (wrapper only).
Empty Object
Response Body
curl -X POST "https://__playground__/verification/v3/tin_fetch/fetch" \ -H "Content-Type: application/json" \ -d '{ "tinNumber": "27123456789" }'{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "TIN Fetch",
"data": {
"result": [
{
"registrationStatus": "ACTIVE",
"cstStatus": "ACTIVE",
"pan": "NOT AVAILABLE",
"dealer": "SUBURBAN SERVICE STATION",
"address": "XXX XXXX, MAHARASHTRA",
"regDate": "XX/XX/2006",
"cancelDate": ""
}
]
}
}{
"detail": {},
"message": "string"
}{
"error": "string"
}Overview
Call POST /verification/v3/tin_fetch/fetch from your backend when you need to fetch Taxpayer Identification Number (TIN) details. This API interfaces with the KwikID gateway.
Key features
- VAT/TIN lookup: Retrieves registration status and details from commercial tax databases.
- Detailed profile: Returns registration status, CST status, PAN (where available), dealer name, address, and registration dates.
Implementation
Step 1: Call from your backend
POST /verification/v3/tin_fetch/fetch HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json
{
"tinNumber": "27123456789"
}Step 2: Use the response
On success (200 OK), the response will return detailed taxpayer metadata:
{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "TIN Fetch",
"data": {
"result": [
{
"registrationStatus": "ACTIVE",
"cstStatus": "ACTIVE",
"pan": "NOT AVAILABLE",
"dealer": "SUBURBAN SERVICE STATION",
"address": "XXX XXXX, MAHARASHTRA",
"regDate": "XX/XX/2006",
"cancelDate": ""
}
]
}
}