Create TDS or TCS certificate job

Create a certificate generation job for Form 130, 131, or 133 with a TAN and tax period. Retrieve the job ID to check its status.

POST /tds/compliance/enriched/traces/deductor/certificates/{certificate_type}

cURL

Submit form 133 job

curl --request POST \
  --url https://test-api.sandbox.co.in/tds/compliance/enriched/traces/deductor/certificates/{certificate_type} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "@entity": "in.co.sandbox.tds.compliance.certificate.job.request",
  "quarter": "Q1",
  "tax_year": "TY 2026-27",
  "tan": "AHMS45586C"
}
'

200

Submit form 133 job

{
  "code": 200,
  "timestamp": 1788770941235,
  "data": {
    "created_at": 1788770941288,
    "@entity": "in.co.sandbox.tds.compliance.certificate.job",
    "job_id": "e75e7d3d-0a44-4454-bfa5-3a2ce3caa2a0",
    "tan": "AHMS45586C",
    "tax_year": "TY 2026-27",
    "quarter": "Q1",
    "status": "created"
  },
  "transaction_id": "e75e7d3d-0a44-4454-bfa5-3a2ce3caa2a0"
}

Before you create a certificate job, add the TRACES credentials for the TAN. If the credentials already exist, you do not need to add them again.

Use 130 for salary TDS, 131 for other TDS, and 133 for TCS in the certificate_type path parameter.

Use the returned job_id to check the certificate job status.

Headers

Authorization · string · required

JWT access token. For token-generation steps, refer to the Quickstart Guide.

x-api-key · string · required

API key used to identify and authenticate the client.

Content-Type · string · required

Request body format.

Path Parameters

certificate_type · enum<string> · required

Certificate type. Use 130 for salary TDS, 131 for other TDS, or 133 for TCS.

Available options: 130, 131, 133

Body

application/json

@entity · string · required

Request entity type.

Allowed value: "in.co.sandbox.tds.compliance.certificate.job.request"

Example:

"in.co.sandbox.tds.compliance.certificate.job.request"

quarter · enum<string> · required

Quarter of the tax year.

Available options: Q1, Q2, Q3, Q4

tax_year · string · required

Tax year for the certificate request. Use the TY YYYY-YY format.

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

Example:

"TY 2026-27"

tan · string · required

Tax Deduction and Collection Account Number (TAN).

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

Example:

"AHMS45586C"

Response

200

application/json

Certificate generation job created.

code · integer · required

timestamp · integer · required

data · object · required

Show child attributes

transaction_id · string · required

Unique identifier for the API transaction.