Prepare TDS Return

TDS return preparation can be an arduous task for Fin-Ops. Automate TDS return preparation using Sandbox APIs.

API Pricing Image


Use this API to prepare TDS return by posting a job to generate the TXT file


  • Businesses need to file their TDS returns quarterly to be TDS compliant.
  • Businesses that deduct TDS under sections 192 (Salary), 194 (Dividends), 194O (E-Commerce Transactions) & 194S (Transfer of Virtual Digital Assets) have volumetric transactions.
  • This makes reporting prone to fat-fingering and other errors that can delay the process of filing the TDS Return and can incur interest & penalty costs.


  • The API will automate the generation of the TXT file which is required to file quarterly TDS returns.
  • Use the PUT request on the presigned_url to upload TDS deduction-related information.
  • Get job_id to obtain the TXT file using the Job status API.
  • You can also configure Postbacks to get notified when the Job is done.


HTTP MethodResource

API Endpoint  Contact Us  Free Trial


Follow the below guidelines to pass TAN, form in the path parameter, and financial year, quarter, previous RRR number, and filing type in the query parameter.

Path Parameter

tanstringTAN of deductorMUMR09719B
formenumTDS return form24Q, 26Q, 27Q

Query Parameter

financial_yearstringPattern : FYeters{1,4}-"data{1,2}FY 2022-23
Possible values: Q1, Q2, Q3, Q4
previous_rrr_numberstringPattern : amete{15}
filing_typeenumTDS Return Filling type.
Possible Values: Original Revised

Sample CURL Request

curl --request POST \
     --url '' \
     --header 'Authorization: xxxxxxxxxxxxxxxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxxxxxxxxxxxxxxxx' \
     --header 'x-api-version: 1.0'

Test Environment Available


codenumberHTTP response status code
timestampnumberTimestamp of the request
transaction_idstringAPI Transaction ID
job_idstringUnique Job ID to track the request
presigned_urlstringS3 URL to make the PUT request


PUT Request on Presigned URL

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


Response Caching

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

Wallet Charges

Since Prepare TDS Return API is a Paid API, a wallet charge will take place.


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