> ## 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 API recipes

> Follow API recipes to prepare and file TDS returns, download filing receipts, and generate TDS certificates through TRACES.

These recipes show how to use Sandbox APIs for Tax Deducted at Source (TDS) compliance. Follow the code samples and API sequences to prepare returns, file them, and generate TDS and TCS certificates.

> [!TIP]
>
> Start with the [TDS API overview](https://developer.sandbox.co.in/api-reference/tds/overview.md) to choose the APIs for your workflow.

***

## Return preparation

Prepare your quarterly TDS returns with validated data and clean TXT output before filing.

> **[Prepare Form 24Q TDS Return](https://developer.sandbox.co.in/recipes/tds/form-24q/prepare_form_24q.md)**
>
> Prepare Form 24Q for salary payments with employee-level TDS details.

> **[Prepare Form 26Q TDS Return](./form-26q/prepare_form_26q)**
>
> Prepare Form 26Q for non-salary payments such as vendors and contractors.

***

## Return filing

File your prepared quarterly returns to the Income Tax Department portal.

> **[File Form 138 TDS returns](https://developer.sandbox.co.in/recipes/tds/form-138/file-form-138.md)**
>
> Validate and e-file salary TDS returns, then download the receipt.

> **[File Form 140 TDS returns](https://developer.sandbox.co.in/recipes/tds/form-140/file-form-140.md)**
>
> Validate and e-file non-salary TDS returns for residents, then download the receipt.

***

## TDS and TCS certificates

Generate TDS and TCS certificates after TRACES processes the relevant statement. Choose a [certificate integration](https://developer.sandbox.co.in/api-reference/tds/compliance/certificates/overview.md#choose-your-integration) based on how you manage TRACES authentication.

> **[Generate certificates with a deductor token](https://developer.sandbox.co.in/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://developer.sandbox.co.in/recipes/tds/form-130/generate-form-130-certificates.md)**
>
> Check when Form 130 certificates, formerly called Form 16, become available for salary TDS.

> **[Generate Form 131 with saved credentials](https://developer.sandbox.co.in/recipes/tds/form-131/generate-form-131-certificates.md)**
>
> Use the enriched APIs to generate Form 131 certificates, formerly called Form 16A, for non-salary deductions.

***

> **[TDS API Reference](https://developer.sandbox.co.in/api-reference/tds/overview.md)**
>
> Explore the complete TDS API documentation with request/response schemas.

> **[Need Help?](https://help.sandbox.co.in/portal)**
>
> Get support for integration questions and troubleshooting.


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