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 | MUMR09719B |
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/MUMR09719B?consent=y&reason=For%20KYC%20purpose' \
--header 'Accept: application/json' \
--header 'Authorization: xxxxxxxxxxx' \
--header 'x-api-key: xxxxxxxxx' \
--header 'x-api-version: 1.0'
Test Environment 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] |
Response Caching
Response caching is not available for this API. Learn more about our response caching mechanism here
Wallet Charges
Since Search TAN API is not a Paid API, no wallet charge will take place.
Versioning
This API is currently in major version 1.0. Refer to the below table for the versioning history of this API along with the Changelog.
| Version | Description | Endpoint |
|---|---|---|
| 1.0 | This is the first version of the API | |
Refer to our versioning policies here
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 about 1 month ago