TDS Certificate Verification

Sample cURL:

curl --location 'https://api-preproduction.signzy.app//api/v3/api/tds-certificate-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth-token>' \
--data '{
    "panNumber": "",
    "tanNumber": "",
    "financialYear": "",
    "tdsCertificateNumber": "",
    "sourceOfIncome": "",
    "tdsAmountAsPerCertificate": ""
}'

Request Headers:

Key	Value
Authorization	shared by Signzy
Content-type	application/json

Request Body:

{
    "panNumber": "DCZPB6760G",
    "tanNumber": "BLRG20902A",
    "financialYear": "2021-22",
    "tdsCertificateNumber": "SUSMXIA",
    "sourceOfIncome": "salaried",
    "tdsAmountAsPerCertificate": "60000"
}

PARAMETERS	DESCRIPTION	TYPE	VALUE (COMPULSORY OR OPTIONAL)
panNumber	Pan number of the individual	String	Mandatory
tanNumber	Tan number of the individual	String	Mandatory
financialYear	Financial Year, accounting period for tax purposes (Format - YYYY-YY (e.g., 2021-22))	String	Mandatory
tdsCertificateNumber	A unique identifier assigned to a Tax Deducted at Source (TDS) certificate.	String	Mandatory
sourceOfIncome	Source of income of the individual (Acceptable values: salaried or non salaried)	String	Optional
tdsAmountAsPerCertificate	The total tax deducted at source as mentioned in the TDS certificate.	String	Mandatory

Response Data:

{
    "result": {
        "validation": "The below particulars do not match with the data available with TRACES",
        "tdsCertificateNumber": "SUSMXIA",
        "financialYear": "2021-22",
        "tanOfDeductor": "BLRG20902A",
        "panOfDeductee": "DCZPB6760G",
        "tdsAmountAsPerCertificate": "60000"
    }
}

PARAMETERS	DESCRIPTION	TYPE
result	The main response object containing TDS validation details.	Object
validation	Message indicating whether the provided details match TRACES records.	String
tdsCertificateNumber	Unique identifier assigned to the TDS certificate.	String
financialYear	The financial year for which TDS was deducted (Format: YYYY-YY)	String
tanOfDeductor	Tax Deduction and Collection Account Number of the deductor.	String
panOfDeductee	Permanent Account Number of the person/entity whose tax was deducted.	String
tdsAmountAsPerCertificate	TDS amount as recorded in the certificate.	String

Response Headers:

PARAMETERS	TYPE	DESCRIPTION
x-signzy-trace-id	String	A unique identifier generated by Signzy to track and debug API requests within their system.
x-trace-id	String	A globally unique trace ID used for end-to-end tracking of API requests across multiple servic

Sample Status Codes and Messages:

{
    "error": {
        "reason": "Error",
        "status": 409,
        "message": "Unable to fetch data from upstream",
        "type": "Conflict",
        "statusCode": 409,
        "name": "error"
    }
}

1. Something went wrong. please try again.
2. Unable to fetch data from upstream