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.

API Pricing Image

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 MethodResource
GET/itd/portal/public/tans/:tan

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass TAN, consent & reason for verification

Path Parameter

ParamTypeDescriptionExample
tanstring10-character alpha-numeric unique identifier for tax deductor1ABC23456D

Query Parameter

ParamTypeDescriptionExample
consentstringConsent of the end-user to get their information for verification purposes.
Possible values: Y or y
Y
reasonstringIndicate 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

FieldDescriptionExample
nameOrgnName of the TAN EntityJOHN DOE PRIVATE LIMITED
nameLastLast Name of TAN Entity if IndividualDOE
nameFirstFirst Name of TAN Entity if IndividualJOHN
nameMidMiddle Name of TAN Entity if IndividualJANE
addLine1Address Line 11, ABC Lakeview Tower,
addLine2Address Line 2Nr. ABC Tower
addLine3Address Line 3Opp. XYZ
addLine4Address Line 4ABCLMN Lane
addLine5Address Line 5Ahmedabad, India-380015
stateCdState Code9
pinPIN Code of the address380015
phoneNumPhone Number of the TAN Entity99xxxxxx83
dtTanAllotmentDate of TAN Allotment1499324427000
emailId1Email ID corresponding to TAN Entity[email protected]
emailId2Alternate 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.

VersionDescriptionEndpoint
1.0This is the first version of the APIAPI Endpoint

Refer to our versioning policies here

State Code

StateState Codes
Andhra Pradesh2
Andaman and Nicobar Islands1
Arunachal Pradesh3
Assam4
Bihar5
Chhatisgarh33
Chandigarh6
Dadra & Nagar Haveli7
Daman & Diu8
Delhi9
Goa10
Gujarat11
Haryana12
Himachal Pradesh13
Jharkhand35
Jammu & Kashmir14
Karnataka15
Kerala16
Lakshwadeep17
Madhya Pradesh18
Maharashtra19
Manipur20
Meghalaya21
Mizoram22
Nagaland23
Odisha24
Puducherry25
Punjab26
Rajasthan27
Sikkim28
Tamil Nadu29
Telengana36
Tripura30
Uttar Pradesh31
Uttarakhand34
West Bengal32