TAN verification_S
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-01 10:36:56
Request Headers
| Header | Description |
|---|---|
myAppId | Application identifier used for service authentication |
service-key | Unique service key provided for accessing the verification service |
Authorization | API authorization credentials for secure access |
Content-Type | Specifies the request payload format (application/json) |
Request Parameters
| Parameter | Type | Description |
|---|---|---|
tanNumber | String | The Tax Deduction and Collection Account Number (TAN) to be verified |
documentType | String | Specifies the verification type (Tan Verification) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the verification process was successful |
message | Status message describing the verification result |
result.isvalid | Indicates whether the provided TAN number is valid |
result.companyName | Name of the company or entity registered with the TAN |
error | Contains error details if verification fails |
Use Cases
- Business verification during onboarding
- Compliance verification for tax-related processes
- Entity validation for financial and fintech platforms
- Fraud prevention in business registrations
Key Benefits
- Instant TAN validity verification
- Reliable retrieval of associated company details
- Improved compliance with tax regulations
- Easy integration with financial and verification systems
Request
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.staging.indiconnect.in/idverifygr/verification' \
--header 'myAppId: verification_v1' \
--header 'service-key: sk_test_a9944179bc598f06' \
--header 'Authorization: x-api-access indc_test_a41eaf2a175f3b13:ac_test_bf7117f6da6c6285' \
--header 'Content-Type: application/json' \
--data-raw '{
"query": "mutation {\r\n verify(\r\n input: {\r\n tanNumber: \"PNEQ00204B\"\r\n documentType: \"Tan Verification\"\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n ... on TanResult {\r\n isvalid\r\n companyName\r\n }\r\n }\r\n error {\r\n status\r\n message\r\n decryptedError\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
{
"data": {
"verify": {
"ok": true,
"message": "Verification completed successfully",
"result": {
"isvalid": true,
"companyName": "QUALITY EDUCATION SUPPORT TRUST"
},
"error": null
}
}
}Modified at 2026-04-01 10:36:56