Download Form 16A

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 MethodEndpoint
POST/tds-compliance/traces/deductors/{tan}/form-16a

API Endpoint Contact Us  Free Trial

Request

Follow the below guidelines to create a job to download Form16A

Path Parameter

ParameterTypeDescriptionExample
tanstringTAN of deductorMUMR09719B

Query Parameter

ParameterTypeDescriptionExample
quarterstringQuarter
Possible Values: Q1, Q2, Q3, Q4
Q1
financial_yearstringFinancial YearFY 2023-24

Body

ParametersTypeValidationDescription
bsr_codestringPattern : [0-9]{7}Bank-Branch Code/ Form 24G Receipt Number
challan_datenumberTimestamp of challan date
challan_serial_nostringPattern : [0-9]{5}Bank Challan No
provisional_receipt_numberstringReceipt Number of TDS Return
challan_amountnumberTotal Challan Amount
unique_pan_amount_combination_for_challanarrayAn array of PANs and amounts deposited against PAN. Require three array objects

unique_pan_amount_combination_for_challan

ParametersTypeValidationDescription
sr_nonumberSerial Number
panstringPattern : [A-Z]{3}[PCFTGHLABJ]{1}[A-Z]{1}[0-9]{4}[A-Z]{1}PAN of the Payer
total_amount_deposited_against_pannumberTotal 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

ParamTypeDescriptionExample
job_idstringThe ID of the job submitted. It will be used later on to check the status.f24cd229-42c8-43de-af79-8ce2d3c4c3db
tanstringTAN of deductorMUMR09719B
financial_yearstringFinancial YearFY 2023-24
quarterstringQuarterQ1
statusstringThe 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