Download Form 16A
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 thequater
andfinancial_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
Updated about 1 month ago