get deprecatedhttps://api.sandbox.co.in/itd/portal/public/tans/
Businesses are required to verify deductors as a part of their KYC and TDS fraud prevention process. However, the current method involves checking one TAN at a time on the Income Tax Portal, which is inefficient. This API can be used in the onboarding flow to enable a more efficient search and retrieval of deductor details.
| Field | Type | Description | Example |
|---|---|---|---|
| nameOrgn | string | Name of the TAN Entity | RON DOE PRIVATE LIMITED |
| nameLast | string | Last Name of TAN Entity if Individual | DOE |
| nameFirst | string | First Name of TAN Entity if Individual | JOHN |
| nameMid | string | Middle Name of TAN Entity if Individual | RON |
| addLine1 | string | Address Line 1 | 1, ABC Tower |
| addLine2 | string | Address Line 2 | Nr. ABC Tower |
| addLine3 | string | Address Line 3 | Opp. XYZ |
| addLine4 | string | Address Line 4 | ABCLMN Lane |
| addLine5 | string | Address Line 5 | Ahmedabad, India-380015 |
| stateCd | number | State | 9 |
| pin | number | PIN Code of the address | 380015 |
| phoneNum | string | Phone Number of the TAN Entity | 99xxxxxx83 |
| dtTanAllotment | number | Date of TAN Allotment | 1499324427000 |
| emailId1 | string | Email ID corresponding to TAN Entity | [email protected] |
| emailId2 | string | Alternate Email ID corresponding to TAN Entity | [email protected] |
Test Environment: https://test-api.sandbox.co.in
| Run in Postman | Response | Remark |
|---|---|---|
| Test Request | 200 | Valid TAN (Company) |
| Test Request | 200 | Valid TAN (Individual) |
| Test Request | 200 | No Records Found |
| Test Request | 422 | Invalid TAN Pattern |
| Test Request | 500 | Failed to get TAN |


