Skip to main content
POST
/
tds
/
compliance
/
traces
/
deductors
/
forms
/
{certificate_type}
Submit TDS Certificate Download Job
curl --request POST \
  --url https://api.sandbox.co.in/tds/compliance/traces/deductors/forms/{certificate_type} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "@entity": "in.co.sandbox.tds.compliance.traces.credentials",
  "username": "<string>",
  "password": "<string>",
  "tan": "<string>",
  "security_captcha": {
    "@entity": "in.co.sandbox.tds.compliance.traces.credentials.security_captcha",
    "quarter": "Q1",
    "financial_year": "FY 2024-25",
    "form": "24Q",
    "bsr_code": "<string>",
    "challan_date": 123,
    "challan_serial_no": "<string>",
    "provisional_receipt_number": "<string>",
    "challan_amount": 123,
    "unique_pan_amount_combination_for_challan": [
      [
        "<string>"
      ]
    ]
  },
  "remember_me": true
}'
{
"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
}
}

Headers

Authorization
string
required

JWT access token

x-api-key
string
required

API key for identification

x-api-version
string

Path Parameters

certificate_type
enum<string>
required
Available options:
form16,
form16a

Body

application/json
@entity
enum<string>
required
Available options:
in.co.sandbox.tds.compliance.traces.credentials
username
string
required

Username of the TRACES portal

password
string
required

The password of the TRACES portal

tan
string
required
security_captcha
object
required

Details required to generate TDS certificates

remember_me
boolean
required

Whether to remember the credentials

Response

200 - OK

code
integer
timestamp
integer
transaction_id
string
data
object