Submit Job

API to E-File your TDS return by uploading the zip of FVU and Form27A on a pre-signed URL

POST /tds/compliance/e-file

cURL

200 Job created

curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/e-file \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.e-file.request",
  "tax_year": "TY 2026-27",
  "form": "138",
  "quarter": "Q2",
  "tan": "AHMA09719B"
}
'

200

200 Job created

{
  "code": 200,
  "timestamp": 1763362637000,
  "transaction_id": "e2b9145f-69d5-4bbe-a6de-be6fc08b426f",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.e-file.job",
    "job_id": "f845f37e-7f05-4de9-a282-a3b23b9d370a",
    "tan": "AHMA09719B",
    "tax_year": "TY 2026-27",
    "quarter": "Q2",
    "form": "138",
    "status": "created",
    "created_at": 1763362637000,
    "fvu_upload_file_url": "https://in-co-sandbox-tds-test-storage.s3.ap-south-1.amazonaws.com/upload/file"
  }
}

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

API version

Body

application/json

@entity · enum<string> · required

Available options: in.co.sandbox.tds.compliance.e-file.request

tax_year · string · required

Tax Year (e.g. TY 2026-27)

Pattern: ^TY [0-9]{4}-[0-9]{2}$

Example:

"TY 2026-27"

form · enum<string> · required

TDS/TCS return form. Use 138 for erstwhile 24Q, 140 for erstwhile 26Q, 144 for erstwhile 27Q, and 143 for erstwhile 27EQ.

Available options: 138, 140, 144, 143

quarter · enum<string> · required

Available options: Q1, Q2, Q3, Q4

tan · string · required

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

Example:

"AHMA09719B"

Response

200 - application/json

200 - OK

code · integer

timestamp · integer

transaction_id · string

data · object

Show child attributes