Skip to main content
POST
The Authorization header requires a deductor access token from Authenticate a TRACES deductor. The token identifies the TAN. Certificate type 131 is for non-salary TDS, and 133 is for TCS. The request body contains only @entity, tax_year, and quarter. Use the returned data.job_id to check the certificate job status. For the complete cURL workflow, see Generate certificates with a deductor token.

Headers

Authorization
string
required

Deductor access token returned by Authenticate a TRACES deductor. The token identifies the deductor TAN.

x-api-key
string
required

Sandbox API key.

Content-Type
string
required

Request body format.

Path Parameters

certificate_type
enum<string>
required

Certificate type. Use 131 for TDS on non-salary payments or 133 for TCS.

Available options:
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"

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"

quarter
enum<string>
required

Quarter of the tax year.

Available options:
Q1,
Q2,
Q3,
Q4

Response

Certificate generation job created.

code
integer
required
timestamp
integer
required
data
object
required
transaction_id
string
required

Unique identifier for the API transaction.