E-File TDS Return

TDS returns have to be filed on a quarterly basis. Deductors can e-file their TDS return with ease by uploading TXT and CSI files.


Use this API to E-File TDS return through TIN FC by generating pre-signed URLs to upload TXT & CSI files.


  • TDS return needs to be filed quarterly in order for the deductor to be TDS compliant.
  • HRMS platforms facilitating the service filing of TDS returns have to do it one at a time by visiting the ITD Portal, making it time-consuming, error-prone & expensive.


  • API that allows you to e-file your TDS return
  • It will also provide you with a job_id to help keep track of your filing status.


HTTP MethodResource

API Endpoint  Contact Us  Free Trial


Form 27A will be e-signed using the Responsible Person's name in the TXT file.


Follow the below guidelines to pass the TAN of the deductor & Form to E-file your TDS return.

Path Parameter

tanstringTAN of deductorPDES03028F
formstringTDS return form
Possible Values: 24Q, 26Q, 27Q

Query Parameter

financial_yearstringFinancial YearFY 2022-23
Possible Values: Q1, Q2, Q3, Q4


PUT Request on Presigned URL

Once the job is successfully created, upload the payload using HTTP PUT method on generated presigned url. Read More

Sample CURL Request

curl --request POST \
     --url https://api.sandbox.co.in/tds-compliance/tin-fc/deductors/PDES03028F/tdsrs/26Q/e-file?financial_year=FY%202022-23&quarter=Q3\
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxxxxxxxxxxxxxx' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: xxxxxxxxxxxxxxxx' \
     --header 'x-api-version: 1.0' \

Test Environment Available


job_idstringThe ID of this job. It will be used later on to check the status.f24cd229-42c8-43de-af79-8ce2d3c4c3db
presigned_url_txtstringPre-signed URL where you need to upload txt filehttps://.......

presigned_url_csistringPre-signed URL where you need to upload CSI filehttps://.....


Response Caching

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

Wallet Charges

Since E-File TDS Return API is a Paid API, a wallet charge as per TIN-FC Charges will be applicable:

Number of Deductee Records in the TDS ReturnWallet Charges (Inclusive of GST)
Upto 100 records59
Between 100-1000 records252
More than 1000 records819


The API is currently in major version 2.0. Refer to the below table for the versioning history of this API along with the Changelog.

VersionDescriptionLink to the endpoint
2.0E-file TDS by uploading TXT & CSI files on a pre-signed URL.API Endpoint
1.0This is the first version of the API.API Endpoint

Refer to our versioning policies here