Submit Job

Create a job to generate the TXT file required to prepare your TDS return

POST /tds/reports/txt

Create TDS Reports Job

cURL

curl --request POST \
  --url https://api.sandbox.co.in/tds/reports/txt \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.reports.request",
  "financial_year": "FY 2024-25",
  "form": "24Q",
  "quarter": "Q1",
  "tan": "AHMA09719B",
  "previous_receipt_number": "123456789123456"
}
'

200

200 - Success

{ "code": 200, "timestamp": 1708926739000, "transaction_id": "c01f847c-c42e-4577-9d01-a7208401a922", "data": { "@entity": "in.co.sandbox.tds.reports.job", "job_id": "c01f847c-c42e-4577-9d01-a7208401a922", "tan": "AHMA09719B", "quarter": "Q3", "form": "26Q", "financial_year": "FY 2023-24", "previous_receipt_number": "123456789012345", "status": "created", "created_at": 1708926739000, "json_url": "https://test-api.sandbox.co.in/tds/reports/in-co-sandbox-tds-reports-test/tan/financial_year/quarter/80716d9a-4aa0-4905-8ff1-0aca61042a0e.json" } }

This endpoint is part of a job-based async workflow. See the job-based API workflow guide for job creation, payload upload, and status polling.

Headers

Authorization · string · required

JWT access token

x-api-key · string · required

API key for identification

x-api-version · string

Body

application/json

@entity · enum<string> · required

Available options: in.co.sandbox.tds.reports.request

financial_year · string · required

Financial Year for which TDS is being filed. (eg. FY 2024-25)

Example:

"FY 2024-25"

form · enum<string> · required

TDS return form

Available options: 24Q, 26Q, 27Q

quarter · enum<string> · required

Quarter for which TDS is being filed

Available options: Q1, Q2, Q3, Q4

tan · string · required

TAN of deductor. Regular Expression: [A-Z]{4}[0-9]{5}[A-Z]{1}

Pattern: [A-Z]{4}[0-9]{5}[A-Z]{1}

Example:

"AHMA09719B"

previous_receipt_number · string

Receipt Number of previously filed TDS Return

Example:

"123456789123456"

Response

200

application/json

200 - OK

code · integer

timestamp · integer

transaction_id · string

data · object

Show child attributes