Search TAN
Tax Deductor/Collector Account Number (TAN) is a 10-digit unique identifier to be obtained by all entities that are responsible for deducting(TDS) or collecting taxes(TCS). Use Search TAN API to verify and get details for a particular TAN.
Overview
This API takes in the tan of a business entity & returns detailed information about the particular TAN.
Problem
- Businesses need to verify the deductors who are deducting TDS on payments toward goods or services sold. TDS fraud can cost millions to businesses.
- Businesses can only verify one TAN at a time by visiting the Income Tax Portal.
Solution
- API to Search the TAN of the deductor and get their details for KYC.
Endpoint
| HTTP Method | Resource |
|---|---|
GET | /itd/portal/public/tans/:tan |
Request
Follow the below guidelines to pass TAN, consent & reason for verification
Path Parameter
| Param | Type | Description | Example |
|---|---|---|---|
| tan | string | 10-character alpha-numeric unique identifier for tax deductor | 1ABC23456D |
Query Parameter
| Param | Type | Description | Example |
|---|---|---|---|
| consent | string | Consent of the end-user to get their information for verification purposes. Possible values: Y or y | Y |
| reason | string | Indicate the purpose for verification. Min length: 20 characters | For KYC purpose |
Sample CURL request
curl --request GET \
--url 'https://api.sandbox.co.in/itd/portal/public/tans/1ABC23456D?consent=y&reason=For%20KYC%20of%20the%20organization' \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxx' \
--header 'x-api-key: xxxxxxxxx' \
--header 'x-api-version: 1.0'
Test Environment Not Available
Response
| Field | Description | Example |
|---|---|---|
| nameOrgn | Name of the TAN Entity | JOHN DOE PRIVATE LIMITED |
| nameLast | Last Name of TAN Entity if Individual | DOE |
| nameFirst | First Name of TAN Entity if Individual | JOHN |
| nameMid | Middle Name of TAN Entity if Individual | JANE |
| addLine1 | Address Line 1 | 1, ABC Lakeview Tower, |
| addLine2 | Address Line 2 | Nr. ABC Tower |
| addLine3 | Address Line 3 | Opp. XYZ |
| addLine4 | Address Line 4 | ABCLMN Lane |
| addLine5 | Address Line 5 | Ahmedabad, India-380015 |
| stateCd | State Code | 9 |
| pin | PIN Code of the address | 380015 |
| phoneNum | Phone Number of the TAN Entity | 99xxxxxx83 |
| dtTanAllotment | Date of TAN Allotment | 1499324427000 |
| emailId1 | Email ID corresponding to TAN Entity | [email protected] |
| emailId2 | Alternate Email ID corresponding to TAN Entity | [email protected] |
State Code
| State | State Codes |
|---|---|
| Andhra Pradesh | 2 |
| Andaman and Nicobar Islands | 1 |
| Arunachal Pradesh | 3 |
| Assam | 4 |
| Bihar | 5 |
| Chhatisgarh | 33 |
| Chandigarh | 6 |
| Dadra & Nagar Haveli | 7 |
| Daman & Diu | 8 |
| Delhi | 9 |
| Goa | 10 |
| Gujarat | 11 |
| Haryana | 12 |
| Himachal Pradesh | 13 |
| Jharkhand | 35 |
| Jammu & Kashmir | 14 |
| Karnataka | 15 |
| Kerala | 16 |
| Lakshwadeep | 17 |
| Madhya Pradesh | 18 |
| Maharashtra | 19 |
| Manipur | 20 |
| Meghalaya | 21 |
| Mizoram | 22 |
| Nagaland | 23 |
| Odisha | 24 |
| Puducherry | 25 |
| Punjab | 26 |
| Rajasthan | 27 |
| Sikkim | 28 |
| Tamil Nadu | 29 |
| Telengana | 36 |
| Tripura | 30 |
| Uttar Pradesh | 31 |
| Uttarakhand | 34 |
| West Bengal | 32 |
Updated 5 days ago