Skip to main content
GET
Get certificate job status
Use the same certificate type as the create request and its returned job_id. The Authorization header requires a deductor access token for the same TAN. Continue polling while data.status is in_progress. A succeeded job includes data.certificate_pdf_zip_urls. A failed job still returns HTTP 200, with the reason in data.message. If token expiry causes HTTP 403, refresh the deductor session and retry with the same job_id. If the refresh token is rejected, authenticate again. See Generate certificates with a deductor token for the complete cURL workflow.

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.

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

Query Parameters

job_id
string
required

Unique identifier returned when the certificate job was created.

Response

Certificate job status and available download URLs.

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