Skip to main content
POST
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.
This endpoint is part of a job-based async workflow. See the job-based API workflow guide for job creation and status polling.Use 130 for salary TDS, 131 for other TDS, and 133 for TCS in the certificate_type path parameter. Set the form request field to the matching JSON string, such as "131".
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.

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.

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.

Example:

"TY 2026-27"

ā€‹
form
enum<string>
required

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

Available options:
130,
131,
133
ā€‹
tan
string
required

Tax Deduction and Collection Account Number (TAN).

Example:

"AHMS45586C"

Response

Certificate generation job created.

ā€‹
code
integer
required
ā€‹
timestamp
integer
required
ā€‹
data
object
required
ā€‹
transaction_id
string
required

Unique identifier for the API transaction.