PAN to TAN API

Endpoint Overview

POST /api/v1/tan/pan-to-tan

Description

The PAN to TAN Lookup API enables you to retrieve a list of Tax Deduction and Collection Account Numbers (TANs) associated with a given Permanent Account Number (PAN) and state. This API is designed to streamline the process of mapping PANs to their corresponding TANs, which is essential for compliance, due diligence, and financial operations.

This endpoint accepts a PAN number and optional filters such as state, search size, and exact match preference. It returns a structured list of companies and their TANs that are linked to the provided PAN, supporting both broad and precise searches.

Key Benefits

Simplifies the process of mapping PAN to TAN for regulatory and business needs.

Supports both broad and exact match searches for flexible integration.

Returns detailed company information for each TAN, aiding in verification and reporting.

Fast, reliable, and secure—ideal for high-volume, real-time applications.

Use Cases

Banking & Financial Services

Fintech & Lending

Enterprise & Compliance

Automate KYC (Know Your Customer) and KYB (Know Your Business) workflows by verifying company TANs from PANs.

Streamline onboarding for vendors and clients by validating tax identities.

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token (JWT) for API authentication
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
id_number	string	Yes	PAN Number
search_size	number	No	Search Size
exact_match	boolean	No	if true, only exact company name matches are returned
state	string	No	State name

Example Request

{
  "id_number": "ABCDE1234F",
  "state": "MAHARASHTRA"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Main response object
data.client_id	string	Unique request identifier
data.pan_number	string	PAN number used in the search
data.search_company_name	string	Company name associated with the PAN
data.search_size	number	Number of results requested
data.search_state	string	State filter applied
data.exact_match	boolean	Indicates if exact match was used
data.hits	number	Number of results returned
data.search_data	array	List of TAN and company name objects
data.search_data[].tan	string	TAN number
data.search_data[].company_name	string	Company name
status_code	number	HTTP status code
success	boolean	Indicates if the request was successful
message	string	Response message
message_code	string	Response message code

Example Successful Response

{
  "data": {
    "client_id": "pan_to_tan_XYZ123ABC456DEF",
    "pan_number": "ABCDE1234F",
    "search_company_name": "SHARMA STEELS PRIVATE LIMITED",
    "search_size": 10,
    "search_state": "MAHARASHTRA",
    "exact_match": false,
    "hits": 10,
    "search_data": [
      {
        "tan": "MUMB01234G",
        "company_name": "SHARMA STEELS PVT LTD"
      },
      {
        "tan": "PUNE05678H",
        "company_name": "PATEL ISPAT LTD"
      },
      {
        "tan": "DELH09876K",
        "company_name": "GUPTA METALS LTD"
      },
      {
        "tan": "BANG02345L",
        "company_name": "NAIR STEEL INDUSTRIES"
      },
      {
        "tan": "HYDE03456M",
        "company_name": "RAO IRON & STEEL PVT LTD"
      },
      {
        "tan": "CHEN04567N",
        "company_name": "KRISHNAN ISPAT AGENCIES"
      },
      {
        "tan": "KOLK06789P",
        "company_name": "M/S VERMA STEELS"
      },
      {
        "tan": "AHMD07890Q",
        "company_name": "SEN METALS PVT LTD"
      },
      {
        "tan": "JAIP08901R",
        "company_name": "AGARWAL ISPAT ENTERPRISES"
      },
      {
        "tan": "LUCK09123S",
        "company_name": "M/S SINGH STEEL WORKS"
      }
    ]
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid PAN Number

Unauthorized

{
   "status_code": 422,
   "success": false,
   "message": "Invalid PAN Number",
   "message_code": null
}

The provided PAN number is not in a valid format.

Integration Best Practices

Security Recommendations

Always use HTTPS to protect sensitive tax information in transit.

Store your API keys and JWT tokens securely; never expose them in client-side code or public repositories.

User Experience Guidelines

Validate PAN and state inputs on the client side before making API calls.

Display clear error messages to users for invalid PANs or authentication failures.

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify the validity and details of a PAN number.

TAN Verification API: Validate a TAN number and retrieve associated company information.

GSTIN to PAN API: Map GSTIN to its corresponding PAN for compliance checks.

Compliance and Legal Considerations

Ensure all PAN and TAN data is handled in accordance with applicable data protection and privacy laws. Use this API only for legitimate business purposes and with proper user consent where required.

This documentation is designed to help you integrate the PAN to TAN Lookup API quickly and securely. For further support, contact Surepass technical support.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/tan/pan-to-tan' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_number": "ABCDE1234F", "state": "MAHARASHTRA" }'

{ "data": { "client_id": "pan_to_tan_XYZ123ABC456DEF", "pan_number": "ABCDE1234F", "search_company_name": "SHARMA STEELS PRIVATE LIMITED", "search_size": 10, "search_state": "MAHARASHTRA", "exact_match": false, "hits": 10, "search_data": [ { "tan": "MUMB01234G", "company_name": "SHARMA STEELS PVT LTD" }, { "tan": "PUNE05678H", "company_name": "PATEL ISPAT LTD" }, { "tan": "DELH09876K", "company_name": "GUPTA METALS LTD" }, { "tan": "BANG02345L", "company_name": "NAIR STEEL INDUSTRIES" }, { "tan": "HYDE03456M", "company_name": "RAO IRON & STEEL PVT LTD" }, { "tan": "CHEN04567N", "company_name": "KRISHNAN ISPAT AGENCIES" }, { "tan": "KOLK06789P", "company_name": "M/S VERMA STEELS" }, { "tan": "AHMD07890Q", "company_name": "SEN METALS PVT LTD" }, { "tan": "JAIP08901R", "company_name": "AGARWAL ISPAT ENTERPRISES" }, { "tan": "LUCK09123S", "company_name": "M/S SINGH STEEL WORKS" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

PAN to TAN

PAN to TAN API#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses