ITR Compliance Check

Endpoint Overview

POST /api/v1/itr/itr-compliance-check

Description

The ITR Compliance Check API allows you to verify the compliance status of a PAN (Permanent Account Number) in India. This endpoint provides comprehensive information about a PAN's validity, Aadhaar linkage status, and compliance with tax regulations under section 206. The API is particularly useful for businesses that need to validate PAN details before processing financial transactions or for regulatory compliance purposes.

Key Benefits

Instant verification of PAN validity and compliance status

Confirmation of PAN-Aadhaar linkage as required by Indian tax regulations

Determination of specified person status under section 206

Access to PAN allotment date and current operational status

Use Cases

Financial Services

Tax & Accounting

HR & Payroll

Verify customer PAN details during account opening processes

Validate PAN compliance before processing high-value transactions

Ensure regulatory compliance for KYC procedures

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 for authentication (JWT format)
Content-Type	Yes	Application/json

Request Body

Parameter	Type	Required	Description
pan_number	String	Yes	The PAN (Permanent Account Number) to be verified (e.g., "AABBCH0123H")

Example Request

{
    "pan_number": "AABBCH0123H"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	The PAN number that was verified
data.compliant	Boolean	Indicates whether the PAN is compliant with regulations
data.pan_allotment_date	String	Date when the PAN was allotted (YYYY-MM-DD format)
data.masked_name	String	Partially masked name of the PAN holder
data.pan_aadhaar_linked	String	Status of PAN-Aadhaar linkage ("linked" or "not linked")
data.specified_person_under_206	String	Indicates if the person falls under section 206 ("yes" or "no")
data.pan_status	String	Current status of the PAN ("operative" or "inoperative")
data.valid_pan	Boolean	Indicates if the PAN is valid
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String	Human-readable message about the response
message_code	String	Code representing the message type

Example Successful Response

{
    "data": {
        "client_id": "itr_compliance_YRjwwjZcGULvxYvlyLFq",
        "pan_number": "AAAAA1111A",
        "compliant": true,
        "pan_allotment_date": "2019-09-20",
        "masked_name": "VXXXXL SXXXH RXXXXXE ",
        "pan_aadhaar_linked": "linked",
        "specified_person_under_206": "no",
        "pan_status": "operative",
        "valid_pan": true
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid PAN

Authentication Error

{
    "data": {
        "client_id": "itr_compliance_YRjwwjZcGULvxYvlyLFq",
        "pan_number": "INVALID123",
        "valid_pan": false
    },
    "status_code": 400,
    "success": false,
    "message": "Invalid PAN format",
    "message_code": "invalid_pan_format"
}

The provided PAN number does not match the required format for Indian PAN cards.

Integration Best Practices

Security Recommendations

Store API keys 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

Implement IP whitelisting if possible for additional security

User Experience Guidelines

Validate PAN format client-side before making API calls

Implement appropriate loading indicators during API calls

Display clear error messages when verification fails

Cache results where appropriate to improve performance

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Verifies PAN details against government records

Aadhaar Verification API: Verifies Aadhaar details and enables e-KYC

GST Verification API: Verifies GST registration details for businesses

Compliance and Legal Considerations

This API provides information related to tax compliance in India. The data should be used in accordance with Indian tax regulations and privacy laws. PAN information is sensitive personal data and should be handled with appropriate security measures. Users should ensure they have proper authorization to verify PAN details of individuals or entities.

{ "data": { "client_id": "itr_compliance_YRjwwjZcGULvxYvlyLFq", "pan_number": "AAAAA1111A", "compliant": true, "pan_allotment_date": "2019-09-20", "masked_name": "VXXXXL SXXXH RXXXXXE ", "pan_aadhaar_linked": "linked", "specified_person_under_206": "no", "pan_status": "operative", "valid_pan": true }, "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 ********************

ITR Compliance Check

ITR Compliance Check#

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

ITR Compliance Check

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples