TDS certificate API

Generate and download Form 131 and Form 133 certificates with a deductor access token or saved TRACES credentials.

The TDS certificate API generates TDS and TCS certificates from TRACES. Use a deductor token or saved TRACES credentials to request certificates, check progress, and download PDF ZIP files.

Supported certificates

The certificate APIs support these forms under the Income-tax Act, 2025. Form 130 is available only through the enriched APIs.

Certificate	Earlier name	Use it for	Integration
Form 130	Form 16	Salary TDS, pension, or specified senior citizen interest	Enriched APIs only
Form 131	Form 16A	TDS on income other than salary	Deductor token or enriched APIs
Form 133	Form 27D	Tax Collected at Source, or TCS	Deductor token or enriched APIs

The Income Tax Department documents these mappings in its Form 130 FAQs, Form 131 FAQs, and Form 133 FAQs.

Choose your integration

Choose how you authenticate the deductor and check job completion.

Integration	Before you request certificates	Check completion
Deductor token	Authenticate the deductor and send the returned deductor access token. You manage token refresh.	Poll the certificate job status.
Enriched APIs	Save the TRACES credentials for the TAN and send your Sandbox access token. Sandbox manages the TRACES session.	Poll the status or configure an enriched certificate webhook.

How it works

1. Request certificates

   Select a supported certificate type in your chosen endpoint. Submit the tax year and quarter in the request body. Include the TAN only for enriched requests.

2. Check progress

   Poll the status endpoint with the returned job_id. Enriched jobs also support webhook notifications.

3. Download certificates

   When the job succeeds, download each ZIP file from data.certificate_pdf_zip_urls in the status response.

Before you start

• A Sandbox API key and access token. See the Quickstart guide.
• The TAN and its TRACES password.
• The certificate type, tax year, and quarter for the request.
• A statement that TRACES has processed, with certificates available for download.

For the deductor-token workflow, authenticate the deductor with your Sandbox access token. Use the returned deductor access token for certificate requests. When that token expires, refresh the deductor session before continuing to poll the same job.

For enriched APIs, save the TRACES credentials for the TAN. Certificate requests use your Sandbox access token.

Form 130 certificate generation is available after the tax year ends and TRACES processes the corresponding Form 138 statement.

Integration guides

Generate certificates with a deductor token

Authenticate the deductor, request Form 131 or Form 133 certificates, and poll for the PDF ZIP files.

Form 130 certificate availability

Check salary certificate prerequisites and availability before submitting a Form 130 job.

Generate Form 131 with saved credentials

Use the enriched APIs to request non-salary TDS certificates and download the PDF ZIP files.

Certificate APIs

With a deductor token

API	Use it to
Create certificate job	Request Form 131 or Form 133 certificate generation.
Get certificate job status	Check progress and retrieve download URLs.

Enriched APIs

API	Use it to
Create certificate job	Request certificate generation.
Get certificate job status	Check progress and retrieve download URLs.
Search certificate jobs	Find previously submitted jobs.
Certificate webhook	Receive success or failure notifications.