Contact UsSupportSignup

Prepare TDS Return

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

Suggest Edits

API Pricing Image

Overview

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

Problem

  • 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.

Solution

  • 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.

Endpoint

HTTP MethodResource
POSTtds-reporting/deductors/{tan}/tdsrs/{form}/async

API Endpoint  Contact Us  Free Trial

Request

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

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

Query Parameter

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

Sample CURL Request 

curl --request POST \
     --url 'https://api.sandbox.co.in/tds-reporting/deductors/MUMR09719B/tdsrs/26Q/async?financial_year=FY%202022-23&quarter=Q4&previous_rrr_number=123456789012345&filing_type=Original' \
     --header 'Authorization: xxxxxxxxxxxxxxxxxxxxxxx' \
     --header 'accept: application/json' \
     --header 'x-api-key: xxxxxxxxxxxxxxxxxxxxxxxx' \
     --header 'x-api-version: 1.0'

✅

Test Environment Available

Response

ParamTypeDescription
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

Payload

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.

Versioning

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

Updated 15 days ago