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/tins

https://api-preproduction.signzy.app/api/v3/tin/tins

Request 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!