Submit Job

Download Form 16 (Part A and Part B).

POST /tds/compliance/traces/deductors/forms/{certificate_type}

cURL

200 - Success

curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.traces.credentials",
  "username": "sandbox.co",
  "password": "Sandbox&2023",
  "tan": "AHMS45586C",
  "security_captcha": {
    "@entity": "in.co.sandbox.tds.compliance.traces.credentials.security_captcha",
    "quarter": "Q4",
    "financial_year": "FY 2025-26",
    "form": "24Q",
    "bsr_code": "6390009",
    "challan_date": 1771824540000,
    "challan_serial_no": "02556",
    "provisional_receipt_number": "780236600264811",
    "challan_amount": 100,
    "unique_pan_amount_combination_for_challan": [
      [
        "sr_no",
        "pan",
        "total_amount_deposited_against_pan"
      ],
      [
        1,
        "CGIPN6158E",
        0
      ],
      [
        2,
        "KIIPS5702K",
        0
      ],
      [
        3,
        "BASPT3106P",
        0
      ]
    ]
  },
  "remember_me": false
}
'

200

200 - Success

{
  "code": 200,
  "timestamp": 1716870600000,
  "transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
  "data": {
    "@entity": "in.co.sandbox.tds.compliance.certificate.job",
    "job_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
    "tan": "AHMA09719B",
    "quarter": "Q4",
    "financial_year": "FY 2023-24",
    "form": "24Q",
    "status": "created",
    "remember_me": false,
    "created_at": 1716870600000
  }
}

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

Path Parameters

certificate_type · string · required

Body

application/json

@entity · enum<string> · required

Entity type identifier. Must be in.co.sandbox.tds.compliance.traces.credentials.

Available options: in.co.sandbox.tds.compliance.traces.credentials

username · string · required

Username of the TRACES portal. Must be a non-empty string.

password · string · required

Password of the TRACES portal. Must be a non-empty string.

tan · string · required

Tax Deduction Account Number (TAN) of the deductor. Must match [A-Z]{4}[0-9]{5}[A-Z]{1} (e.g., AHMA09719B).

security_captcha · object · required

Challan and return details used to authenticate the TRACES session and identify the certificate to download.

Show child attributes

remember_me · boolean · required

Whether to save the TRACES credentials for future requests. When true, subsequent jobs can be submitted without re-entering credentials.

Response

200

application/json

200 - OK

code · integer

timestamp · integer

transaction_id · string

data · object

Show child attributes