TAN Verification — Tax Deductor Lookup
Verify a TAN and retrieve the deductor's name, category, and status. Essential for TDS compliance and vendor verification.
curl -X GET "https://production.deepvue.tech/v1/verification/tax-payer/tan?tan_number=example_string" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN (JWT)" \
-H "x-api-key: YOUR_API_KEY"
import requests
import json
url = "https://production.deepvue.tech/v1/verification/tax-payer/tan?tan_number=example_string"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://production.deepvue.tech/v1/verification/tax-payer/tan?tan_number=example_string", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN (JWT)",
"x-api-key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://production.deepvue.tech/v1/verification/tax-payer/tan?tan_number=example_string", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN (JWT)")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://production.deepvue.tech/v1/verification/tax-payer/tan?tan_number=example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN (JWT)'
request['x-api-key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"code": 200,
"timestamp": 1738561863604,
"transaction_id": "2ee6595b-5ce6-42a1-9660-a7092f5cd1d1",
"data": {
"nameOrgn": "AMAZON SELLER SERVICES PRIVATE LIMITED",
"addLine1": "26/1 8TH FLOOR",
"addLine2": "BRIGADE GATEWAY",
"addLine3": "DR.RAJKUMAR ROAD",
"addLine5": "BANGALORE",
"stateCd": 15,
"pin": 560055,
"phoneNum": "9xxxxxxxx9",
"dtTanAllotment": 1293691500000,
"emailId1": "RxxxxxxxxxxxxxxxxxM"
},
"message": "TAN Verified Successfully"
}
{
"code": 200,
"timestamp": 1738561895999,
"transaction_id": "99a67f74-728f-4559-8825-a4bc872d6084",
"data": {},
"message": "No record found"
}
{
"detail": "Inactive client_id"
}
{
"detail": "Not authenticated"
}
{
"detail": "Not a valid token"
}
{
"code": 422,
"timestamp": 1738561797252,
"transaction_id": "38c2297c-29c1-49d4-8da7-e87105e7ac1d",
"message": "Invalid Tan pattern"
}
{
"detail": "Internal Server Error"
}
{
"code": 503,
"timestamp": 1738561895999,
"transaction_id": "99a67f74-728f-4559-8825-a4bc872d6084",
"message": "Source Unavailable"
}
/v1/verification/tax-payer/tan
ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token (JWT). ACCESS_TOKEN generated from the authorize endpoint. Should be included in the header as Bearer .
API Key for authentication. The CLIENT_SECRET provided to you. This header parameter is required for authentication purposes.
Query Parameters
Responses
Overview
This API enables verification of Tax Deduction and Collection Account Numbers (TANs) and retrieves associated organizational details from authoritative sources.
The endpoint accepts a 10-digit alphanumeric TAN number as input. Upon successful verification, it returns organizational information including:
- Organization name
- Complete address (multiple lines)
- State code and PIN
- Contact details (phone and email)
- TAN allotment date
The API handles two primary outcomes: successful TAN verification returning full organizational data, or a "no record found" response when the TAN does not exist in the system.
Last updated 4 weeks ago
Built with Documentation.AI