> ## Documentation Index
> Fetch the complete documentation index at: https://developer.sandbox.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# TDS certificate API

> Generate and download TDS and TCS certificates: Form 130 (formerly Form 16), Form 131 (formerly Form 16A), and Form 133.

Generate and download TDS and TCS certificates from TRACES with Sandbox's certificate API. Add certificate generation to your payroll, accounting, or tax software.

<div id="choose-a-certificate" />

## Supported certificates

The API supports these certificates under the Income-tax Act, 2025.

| Certificate                                                      | Earlier name | Use it for                                                |
| :--------------------------------------------------------------- | :----------- | :-------------------------------------------------------- |
| [Form 130](/recipes/tds/form-130/generate-form-130-certificates) | Form 16      | Salary TDS, pension, or specified senior citizen interest |
| [Form 131](/recipes/tds/form-131/generate-form-131-certificates) | Form 16A     | TDS on income other than salary                           |
| Form 133                                                         | Form 27D     | Tax Collected at Source, or TCS                           |

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).

<div id="what-you-receive" />

<div id="certificate-downloads" />

## How it works

<Steps>
  <Step title="Request certificates">
    Submit a request for the TAN, certificate type, and tax period.
  </Step>

  <Step title="Check progress">
    Check the job status periodically, or configure a webhook before submitting the job to receive a completion notification.
  </Step>

  <Step title="Download certificates">
    When the job succeeds, use the download URLs in the status response to download ZIP files containing the certificate PDFs.
  </Step>
</Steps>

<div id="what-you-need" />

<div id="requirements" />

<div id="frequently-asked-questions" />

## Before you start

* A Sandbox access token. See the [Quickstart guide](/guides/get-started/quickstart).
* The TAN and its [TRACES credentials](/api-reference/tds/compliance/traces-credentials/endpoints/save_credential).
* The certificate type, tax year, and quarter for the request.
* A statement that TRACES has processed, with certificates available for download.

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

<div id="certificate-integration-guides" />

## Integration guides

<CardGroup cols={2}>
  <Card title="Form 130 certificate availability" icon="file-lines" href="/recipes/tds/form-130/generate-form-130-certificates">
    Check salary certificate prerequisites and availability before submitting a Form 130 job.
  </Card>

  <Card title="Generate Form 131 certificates" icon="file-lines" href="/recipes/tds/form-131/generate-form-131-certificates">
    Follow the cURL examples to create a non-salary TDS certificate job and download the certificates.
  </Card>
</CardGroup>

<div id="certificate-endpoints" />

## Certificate APIs

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

## Existing integrations

<div id="form-16-and-form-16a-api-migration" />

<Accordion title="Updating an existing Form 16 or Form 16A integration?">
  Form 130 replaces Form 16, and Form 131 replaces Form 16A. For an existing API integration, update these request fields and response handlers.

  | Integration detail    | Earlier certificate API                       | Current certificate API                                 |
  | :-------------------- | :-------------------------------------------- | :------------------------------------------------------ |
  | Certificate selection | Form 16 or Form 16A workflow                  | `130` or `131` in the `certificate_type` path parameter |
  | Request `form`        | Statement form such as `24Q`, `26Q`, or `27Q` | Certificate form string `"130"` or `"131"`              |
  | Tax period            | `financial_year`                              | `tax_year`, for example `"TY 2026-27"`                  |
  | Check job status      | `POST` request                                | `GET` request with `job_id` in the query string         |
</Accordion>