TIN Fetch_S
POST
https://api.staging.indiconnect.in/idverifygr/verification
Last modified:2026-04-06 06:27:14
It provides key information such as dealer name, registration status, CST status, PAN (if available), address, and registration date.
It helps organizations ensure the authenticity of business entities and maintain accurate financial records.
dealer information, registration status, CST status, PAN details, and address information.
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 |
|---|---|---|
tinNumber | String | Taxpayer Identification Number used to fetch business details |
documentType | String | Specifies the verification type (TIN Fetch_S) |
Response Fields
| Field | Description |
|---|---|
ok | Indicates whether the request was successful (true / false) |
message | Status message describing the result |
result.records.dealer | Name of the business/dealer |
result.records.registrationStatus | Status of the TIN registration (e.g., ACTIVE) |
result.records.cstStatus | Status of CST (Central Sales Tax) registration |
result.records.pan | PAN associated with the TIN (if available) |
result.records.address | Registered address of the business |
result.records.regDate | Date of registration |
error | Contains error details if the request fails |
Use Cases
- Business verification and onboarding
- Validation of legacy tax records
- Compliance and KYC checks
- Vendor and partner verification
Key Benefits
- Quick retrieval of business information using TIN
- Supports compliance and verification workflows
- Reliable validation of legacy tax data
- Easy integration for real-time verification
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_v5_app' \
--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 documentType: \"TIN Fetch_S\"\r\n tinNumber: \"27290171042\" \r\n # Taxpayer Identification Number\r\n }\r\n ) {\r\n ok\r\n message\r\n result {\r\n __typename\r\n ... on TinFetchResult {\r\n records {\r\n dealer\r\n registrationStatus\r\n cstStatus\r\n pan\r\n address\r\n regDate\r\n }\r\n }\r\n }\r\n error {\r\n decryptedError\r\n }\r\n }\r\n}\r\n",
"variables": {}
}'Response Response Example
{
"statusCode": 0,
"body": {
"status": "string",
"code": 0,
"message": "string",
"timestamp": "string",
"errors": [
"string"
]
}
}Modified at 2026-04-06 06:27:14