TIN Fetch API
Introduction
The TIN (Taxpayer Identification Number) API is designed to streamline the process of verifying and obtaining detailed information about businesses using their TIN. By inputting a valid TIN, the API returns a comprehensive response containing crucial business information, including registration status, registration date, PAN (Permanent Account Number), owner & dealer details, address breakdown, and more.
Note: TIN is also known by VAT Number, CST Number, or Sales Tax Number
Use Cases
- Compliance and Verification:Businesses and financial institutions can use the TIN API to verify vendors' and partners' registration and compliance status, ensuring adherence to regulatory standards.
- Due Diligence:Organizations can perform due diligence during mergers, acquisitions, or onboarding new clients by validating the provided business details against official records.
- KYB (Know Your Business):Financial institutions and service providers can integrate the API into their KYC processes to confirm the authenticity of business entities.
- Risk Management:Credit agencies and risk management departments can use the API to assess businesses' credibility and operational status before extending credit or entering into contracts.
- Data Enrichment:Enhance business databases with accurate and up-to-date information retrieved from the TIN API, improving data quality and decision-making processes.

API details
Endpoint
https://api.signzy.app/api/v3/tin/tinshttps://api-preproduction.signzy.app/api/v3/tin/tinsRequest Headers
Name | Value | Required | Description |
|---|---|---|---|
Content-type | application/json | Mandatory | The type of content that the request body contains. |
Authorization | XXXXXXXXXXXXXXX | Mandatory | An authentication token to authorize the request. Reach out to the Signzy support team to get one created |
Request body parameters
Parameter | Data Type | Description | Required |
|---|---|---|---|
tinNumber | string | Tax Identification Number | Mandatory |
{
"tinNumber":"<tinNumber>"
}Code samples
package main
import (
"fmt"
"strings"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api-preproduction.signzy.app/api/v3/tin/tins"
method := "POST"
payload := strings.NewReader(`{
"tinNumber": "<tinNumber>"
}`)
client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)
if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Authorization", "<Token>")
res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()
body, err := ioutil.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}Response body parameters
Parameter Name | Data Type | Description |
|---|---|---|
result.registrationStatus | String | Registration status (e.g., "CANCELLED") |
result.cstStatus | String | CST (Central Sales Tax) status (e.g., "CANCELLED") |
result.pan | String | PAN (Permanent Account Number) |
result.status | String | Status information (may be empty) |
result.ownerName | String | Owner's name (may be empty) |
result.dealer | String | Dealer's name (e.g., "M/S TUNGALOY INDIA PRIVATE LIMITED") |
result.address | String | Full address |
result.splitAddress | Object | Contains various address components |
result.splitAddress.district | Array of Strings | District(s) of the address |
result.splitAddress.state | Array of Arrays | State information, including name and abbreviation |
result.splitAddress.city | Array of Strings | City or cities in the address |
result.splitAddress.pincode | String | Postal code (PIN code) |
result.splitAddress.country | Array of Strings | Country information, including ISO codes |
result.splitAddress.addressLine | String | Concatenated address line |
result.regDate | String | Registration date (format: DD/MM/YYYY) |
result.cancelDate | String | Cancellation date (may be empty) |
"result": [
{
"registrationStatus": "CANCELLED",
"cstStatus": "CANCELLED",
"pan": "<PanNumber>",
"status": "",
"ownerName": "",
"dealer": "M/S TUNGALOY INDIA PRIVATE LIMITED",
"address": "TOWER NO.1,UNIT 9,NDIABULLS FINANCE CE,MUMBAI,MUMBAI,TON ROAD WEST)MUMBAISENAPATI MAHARASHTRA",
"splitAddress": {
"district": [
"MUMBAI"
],
"state": [
[
"MAHARASHTRA",
"MH"
]
],
"city": [
"MUMBAI"
],
"pincode": "400033",
"country": [
"IN",
"IND",
"INDIA"
],
"addressLine": "TOWER NO.1,UNIT 9,NDIABULLS FINANCE CE,TON ROAD WEST)SENAPATI"
},
"regDate": "19/03/2010",
"cancelDate": ""
}
]List of State Codes for First Two Digits of TIN Numbers
Sl. No. | State Name | TIN number - First two digits | State Code |
|---|---|---|---|
1 | Andaman and Nicobar Islands | 35 | AN |
2 | Andhra Pradesh | 28 | AP |
3 | Andhra Pradesh (New) | 37 | AD |
4 | Arunachal Pradesh | 12 | AR |
5 | Assam | 18 | AS |
6 | Bihar | 10 | BH |
7 | Chandigarh | 04 | CH |
8 | Chattisgarh | 22 | CT |
9 | Dadra and Nagar Haveli | 26 | DN |
10 | Daman and Diu | 25 | DD |
11 | Delhi | 07 | DL |
12 | Goa | 30 | GA |
13 | Gujarat | 24 | GJ |
14 | Haryana | 06 | HR |
15 | Himachal Pradesh | 02 | HP |
16 | Jammu and Kashmir | 01 | JK |
17 | Jharkhand | 20 | JH |
18 | Karnataka | 29 | KA |
19 | Kerala | 32 | KL |
20 | Lakshadweep Islands | 31 | LD |
21 | Madhya Pradesh | 23 | MP |
22 | Maharashtra | 27 | MH |
23 | Manipur | 14 | MN |
24 | Meghalaya | 17 | ME |
25 | Mizoram | 15 | MI |
26 | Nagaland | 13 | NL |
27 | Odisha | 21 | OR |
28 | Pondicherry | 34 | PY |
29 | Punjab | 03 | PB |
30 | Rajasthan | 08 | RJ |
31 | Sikkim | 11 | SK |
32 | Tamil Nadu | 33 | TN |
33 | Telangana | 36 | TS |
34 | Tripura | 16 | TR |
35 | Uttar Pradesh | 09 | UP |
36 | Uttarakhand | 05 | UT |
37 | West Bengal | 19 | WB |
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!