Skip to main content

​
TDS Calculator API

TDS Calculator is an API suite for calculating tax deducted at source (TDS) for salary and non-salary payments. Use these APIs to compute TDS amounts and rates for payroll and payouts—call synchronously for immediate results or asynchronously for bulk processing.

​
Value proposition

Correct TDS calculation requires applying the right rates and rules for each payment type, recipient status, and Income Tax Act section. Manual computation is error-prone and slow, especially when processing high volumes of salary or vendor payments. TDS Calculator APIs automate these calculations. The APIs produce accurate deductions that comply with Income Tax Act provisions and reduce compliance risk.

Salary TDS calculation

Compute TDS for employee salary payments and generate detailed workbooks.

Non-salary TDS calculation

Calculate TDS for contractor, vendor, and other non-salary payouts.

Sync and async modes

Use synchronous APIs for real-time results or async jobs for bulk processing.

Workbook input/output

Submit salary workbooks and get computed results with TDS details.

​
How it works

1

Choose calculation mode

Determine whether you need salary or non-salary TDS calculation.
2

Call non-salary calculator (if applicable)

Send payment details to the non-salary endpoint and receive computed TDS values.
3

Call salary sync (for single computations)

Submit the salary workbook and receive the computed output synchronously.
4

Submit salary job (for bulk processing)

Call the submit job endpoint to get a job ID and upload URL for large payroll files.
5

Upload input workbook

Use PUT request to upload the salary workbook to the provided upload URL.
6

Poll job status or receive webhook

Check job status periodically or configure a webhook to receive completion notification.
7

Download computed output

Retrieve the computed workbook with TDS values from the job result URL.
For bulk salary calculations, see the job-based API workflow guide.

​
API reference

Non-salary calculation

Calculate TDS for contractor and vendor payments.

Salary calculation (sync)

Compute salary TDS with immediate response.

Submit salary job

Initiate bulk salary TDS calculation job.

Poll salary job

Check status and retrieve results for bulk jobs.

​
API endpoints

APIPurpose
Non-salary paymentsCalculate TDS for non-salary payments like contractor fees, rent, and professional services
Salary payments (sync)Compute TDS for salary payments with synchronous response
Submit salary jobCreate an async job for bulk salary TDS calculation
Poll salary jobRetrieve job status and download computed results

​
Common use cases

Use TDS Calculator APIs when you need to:
  • Calculate TDS for contractor or vendor payouts before initiating payment
  • Compute employee salary TDS during payroll processing and generate output workbook
  • Run bulk salary TDS calculations for enterprises with large payroll files
  • Integrate TDS computation into HRMS or ERP systems for monthly compliance workflows

Job-based APIs

Understand async job workflows for bulk processing.

Webhooks

Configure webhooks for job completion notifications.

Error handling

Handle API errors and troubleshoot issues.

Authentication

Set up API authentication.

​
FAQ

TDS Calculator API is a Sandbox API suite that computes tax deducted at source (TDS) for salary and non-salary payments. The API applies Income Tax Act rules to calculate accurate TDS amounts based on payment type, recipient details, and applicable sections.
Salary TDS calculation applies to employee compensation and uses workbook-based input/output with detailed computation. Non-salary TDS calculation applies to payments like contractor fees, rent, and professional services, using a simpler request/response format. Both follow Income Tax Act provisions but use different rate structures and exemptions.
Use synchronous salary calculation via the salary sync endpoint for single employee computations with immediate response needs. Use asynchronous job-based calculation via submit job for bulk payroll processing with large workbooks. See the job-based API workflow for async details.
Submit a bulk calculation job using the submit job endpoint, which returns a job ID and upload URL. Upload your salary workbook via PUT request to the upload URL. Poll the poll job endpoint or configure a webhook to receive completion notification. Download the computed output from the result URL in the job response.
TDS Calculator accepts salary data in workbook format for both input and output. The input workbook contains employee salary details, deductions, and exemptions. The output workbook includes computed TDS amounts, applicable rates, and calculation breakdowns. Refer to the endpoint documentation for schema details.
TDS Calculator APIs help businesses comply with Income Tax Act TDS provisions. The APIs calculate accurate tax deductions so you can deposit payments on time, issue TDS certificates (Form 16/16A), and file quarterly returns correctly. See the TDS overview for the complete compliance workflow.
TDS Calculator APIs return standard error responses with error codes and messages. Common errors include invalid input data, missing required fields, or unsupported payment types. See the error handling guide for error code reference and troubleshooting steps.