TAN Verification

Endpoint Overview

POST /api/v1/tan/

Description

The TAN Verification API allows you to validate and retrieve key details associated with a Tax Deduction and Collection Account Number (TAN) in India. This endpoint returns the TAN holder's full name and other essential information after verifying the provided TAN number against official records.

Key Benefits

Instant verification of TAN numbers against authoritative sources

Retrieval of accurate TAN holder details for compliance purposes

Reduction in manual verification efforts and associated errors

Streamlined KYC and onboarding processes for business customers

Use Cases

Financial Services

Tax Services

Enterprise Solutions

Verify business client identity during account opening procedures

Validate TAN details before processing high-value transactions

Automate compliance checks for corporate banking customers

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.io

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT format: `Bearer <your_token>`
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
id_number	String	Yes	The TAN number to be verified (e.g., "RTKT06731E")

Example Request

{
    "id_number": "RTKT06731E"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the verification result details
data.client_id	String	Unique identifier for the verification request
data.tan	String	The verified TAN number
data.name	String	Full name of the TAN holder (company or entity)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the verification was successful
message	String	Human-readable status message
message_code	String	Machine-readable status code

Example Successful Response

{
    "data": {
        "client_id": "tan_kjYdJwRvRJQszuvgdruK",
        "tan": "RTKT06731E",
        "name": "TAXREX SOLUTIONS PRIVATE LIMITED"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid TAN

TAN Not Found

Authentication Error

{
    "status_code": 400,
    "success": false,
    "message": "Invalid TAN number format",
    "message_code": "invalid_input"
}

The provided TAN number does not match the required format or contains invalid characters.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Rotate JWT tokens periodically and implement token expiration policies

User Experience Guidelines

Implement client-side validation for TAN format before making API calls

Display clear error messages to users when verification fails

Provide a loading indicator during API calls to improve perceived performance

Cache successful verification results (where appropriate) to reduce redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verify Permanent Account Number details for individuals and entities

GST Verification API: Validate Goods and Services Tax registration information

CIN Verification API: Retrieve Corporate Identity Number details for registered companies

Business Verification API: Comprehensive verification of business entities using multiple identifiers

Compliance and Legal Considerations

This API accesses official TAN records and should be used in compliance with Indian tax regulations. Usage of this API should adhere to data privacy laws, and the information obtained should only be used for legitimate business purposes such as KYC, compliance verification, or fraud prevention. Ensure you have appropriate consent before verifying TAN information.

{ "data": { "client_id": "tan_kjYdJwRvRJQszuvgdruK", "tan": "RTKT06731E", "name": "TAXREX SOLUTIONS PRIVATE LIMITED" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

TAN Verification

TAN Verification#

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

TAN Verification

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples