KwikID DocumentationTAN Verification
Performs TAN details verification via KwikID.
TAN Verification
API reference
Try itLoading playground…
Loading…
AuthorizationBearer <token>
JWT Bearer token authentication. Obtain a token from the KwikID dashboard.
In: header
tanstring
Tax Deduction and Collection Account Number.
consentstring
Consent code (must be 'Y').
clientData?object
Custom metadata to associate with the request.
Empty Object
Response Body
curl -X POST "https://__playground__/verification/v3/tan_verification/verify" \ -H "Content-Type: application/json" \ -d '{ "tan": "MUMD12345F", "consent": "Y" }'{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "TAN Verification",
"data": {
"result": {
"name": "DECCAN CHRONICLE SECUNDERABAD PRIVATE LIMITED"
},
"request_id": "31f1714a-192d-406a-b3ad-bec7040c7d7a",
"status-code": "101"
}
}{
"detail": {},
"message": "string"
}{
"error": "string"
}Overview
Call POST /verification/v3/tan_verification/verify from your backend to verify Tax Deduction and Collection Account Number (TAN) registration details using KwikID.
Key features
- Official details: Fetches the registered entity name associated with the TAN.
- Verification source: Authenticates details against the Income Tax Department database via KwikID.
Implementation
Step 1: Call from your backend
POST /verification/v3/tan_verification/verify HTTP/1.1
Host: <verification-api-base-url>
Authorization: Bearer <token>
Content-Type: application/json
{
"tan": "MUMD12345F",
"consent": "Y"
}Step 2: Use the response
On success (200 OK), the response returns registered name details:
{
"success": true,
"status_code": 200,
"provider": "KwikID",
"api_name": "TAN Verification",
"data": {
"result": {
"name": "DECCAN CHRONICLE SECUNDERABAD PRIVATE LIMITED"
},
"request_id": "31f1714a-192d-406a-b3ad-bec7040c7d7a",
"status-code": "101"
}
}