> ## Documentation Index
> Fetch the complete documentation index at: https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/form-130/generate-form-130-certificates.md) | Form 16 | Salary TDS, pension, or specified senior citizen interest | Enriched APIs only |
| [Form 131](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/form-131/generate-form-131-certificates.md) | 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](https://www.incometaxindia.gov.in/documents/d/guest/form-130-faqs), [Form 131 FAQs](https://www.incometaxindia.gov.in/documents/d/guest/form-131-faqs), and [Form 133 FAQs](https://www.incometaxindia.gov.in/documents/d/guest/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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/certificates/generate-with-deductor-token.md) | Authenticate the deductor and send the returned deductor access token. You manage token refresh. | Poll the certificate job status. |
| [Enriched APIs](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/submit_job.md) | 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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/webhook.md).

**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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/guides/get-started/quickstart.md).
* 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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/traces/endpoints/authenticate.md) with your Sandbox access token. Use the returned deductor access token for certificate requests. When that token expires, [refresh the deductor session](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/traces/endpoints/refresh.md) before continuing to poll the same job.

For enriched APIs, [save the TRACES credentials](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/traces-credentials/endpoints/save_credential.md) for the TAN. Certificate requests use your Sandbox access token.

> [!NOTE]
>
> 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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/certificates/generate-with-deductor-token.md)**
>
> Authenticate the deductor, request Form 131 or Form 133 certificates, and poll for the PDF ZIP files.

> **[Form 130 certificate availability](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/form-130/generate-form-130-certificates.md)**
>
> Check salary certificate prerequisites and availability before submitting a Form 130 job.

> **[Generate Form 131 with saved credentials](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/recipes/tds/form-131/generate-form-131-certificates.md)**
>
> 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](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/submit_with_deductor_token.md) | Request Form 131 or Form 133 certificate generation. |
| [Get certificate job status](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/poll_with_deductor_token.md) | Check progress and retrieve download URLs. |

### Enriched APIs

| API | Use it to |
| :- | :- |
| [Create certificate job](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/submit_job.md) | Request certificate generation. |
| [Get certificate job status](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/poll_job.md) | Check progress and retrieve download URLs. |
| [Search certificate jobs](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/fetch_job.md) | Find previously submitted jobs. |
| [Certificate webhook](https://sandboxfinancialtechnologiesprivatelimited.mintlify.site/api-reference/tds/compliance/certificates/endpoints/webhook.md) | Receive success or failure notifications. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.