API Pricing Image

Overview

The API enables you to download Form 16A from the TRACES portal

Problem

Manually downloading large volumes of files like millions of Form 16A becomes a tedious and time-consuming process

Solution

This API takes the tan of the deductor as the path parameter. It takes the quater and financial_year for which Form 16A needs to be generated in the query parameters. In the body parameters, it takes thebsr_code, challan_date, challan_serial_no, challan_amount, unique_pan_amount_combination_for_challan of the challan which was part of the previously filled TDS return
Automating the consent-based retrieval of Form 16A
This API will return the JOB ID which can be used to get the status of the Form 16A download

Endpoint

HTTP Method	Endpoint
POST	/tds-compliance/traces/deductors/{tan}/form-16a

Request

Follow the below guidelines to create a job to download Form16A

Path Parameter

Parameter	Type	Description	Example
tan	`string`	TAN of deductor	`MUMR09719B`

Query Parameter

Parameter	Type	Description	Example
quarter	`string`	Quarter Possible Values: `Q1`, `Q2`, `Q3`, `Q4`	`Q1`
financial_year	`string`	Financial Year	`FY 2023-24`

Body

Parameters	Type	Validation	Description
bsr_code	`string`	Pattern : [0-9]{7}	Bank-Branch Code/ Form 24G Receipt Number
challan_date	`number`		Timestamp of challan date
challan_serial_no	`string`	Pattern : [0-9]{5}	Bank Challan No
provisional_receipt_number	`string`		Receipt Number of TDS Return
challan_amount	`number`		Total Challan Amount
unique_pan_amount_combination_for_challan	`array`		An array of PANs and amounts deposited against PAN. Require three array objects

unique_pan_amount_combination_for_challan

Parameters	Type	Validation	Description
sr_no	`number`		Serial Number
pan	`string`	Pattern : [A-Z]{3}[PCFTGHLABJ]{1}[A-Z]{1}[0-9]{4}[A-Z]{1}	PAN of the Payer
total_amount_deposited_against_pan	`number`		Total TDS deposited against the PAN in this Challan

Once the values are added, Your curl will look something like this

curl --request POST \
     --url 'https://api.sandbox.co.in/tds-compliance/traces/deductors/MUMR09719B/form-16a?quarter=Q1&financial_year=FY%202023-24' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-version: 1.0'
     --data '
{
    "bsr_code": "1234567",
    "challan_date": 1670783400000,
    "challan_serial_no": "01234",
    "provisional_receipt_number": "990000123469999",
    "challan_amount": 18000.0,
    "unique_pan_amount_combination_for_challan": [
        [
            "sr_no",
            "pan",
            "total_amount_deposited_against_pan"
        ],
        [
            1,
            "COWPR7618C",
            6000
        ],
        [
            2,
            "COWPR7618C",
            6000
        ],
        [
            3,
            "COWPR7618C",
            6000
        ]
        
    ]
}
'

✅
Test Environment Available

Response

Param	Type	Description	Example
job_id	`string`	The ID of the job submitted. It will be used later on to check the status.	`f24cd229-42c8-43de-af79-8ce2d3c4c3db`
tan	`string`	TAN of deductor	`MUMR09719B`
financial_year	`string`	Financial Year	`FY 2023-24`
quarter	`string`	Quarter	`Q1`
status	`string`	The status of the job submitted.	`JOBQUEUED`

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since Download Form 16A is a Paid API, a wallet charge of 0.1 + GST per TDS Certificate will be applicable.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here