TDS Calculator

TDS has to be deducted at the prescribed rate based on the nature of the payment. Use Sandbox APIs to calculate the applicable TDS rate.

API Pricing Image

Overview

Calculate tds_amount & tds_rate applicable for a given payment using this API

Problem

  • Tax Deducted at Source (TDS) is an indirect method of collecting Income Tax.
  • TDS can be deducted by Company, Association of Persons, Trust, Artificial Juridical Person, Body of Individuals, Individual, HUF, & Firm.
  • The deductor has to deduct TDS when making payments of specified nature at a prescribed rate and deposit the same with the Government.
  • However, it can be tedious to determine the TDS rate or the section that is applicable to every deductee, making the process error-prone and inefficient.

Solution

  • API that calculates the TDS liability, making the process fast and efficient.

Endpoint

HTTP MethodEndpoint
POSTcalculators/tds

API Endpoint  Contact Us  Free Trial

Request

Follow the below guidelines to pass payment details to calculate TDS.

Body

A Request Body (JSON) is uploaded for calculating the TDS Tax Liabilities.

ParametersRequiredTypeDescriptionExample
deductee_typeYesstringType of Deductee Possible Values:
Individual, HUF, Company,
Firm, Trust
Individual
is_pan_availableYesstringIs the PAN of the deductee available?
Possible Values: Y, N
Y
residential_statusYesstringResidential Status of the user
Possible Values:
Resident, Non Resident
Resident
nature_of_paymentYesstringType of the payment being made. Nature of PaymentsCargo Handling Services Inspection And Logistics Services
credit_amountYesnumPayment amount (in INR)250000
credit_dateYesstringDate of payment
Format: DD/MM/YYYY
20/02/2021

Sample CURL request

curl --request POST \
     --url https://api.sandbox.co.in/calculators/tds \
     --header 'Accept: application/json' \
     --header 'Authorization: xxxxxxxx' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: xxxxxxxxxx' \
     --header 'x-api-version: 1.0' \
     --data '
{
     "deductee_type": "Individual",
     "is_pan_available": "Y",
     "residential_status": "Resident",
     "nature_of_payment": "Cargo Handling Services Inspection And Logistics Services",
     "credit_amount": 250000,
     "credit_date": "20/02/2021"
}
'

❗️

Test Environment Not Available

Response

ParamTypeDescriptionExample
deductee_typestringType of Deductee Possible Values:
Individual, HUF, Company,
Firm, or Trust
Individual
is_pan_availablestringReturns Y or N.Y
residential_statusstringResidential Status of the user. Possible Values: Resident, Non ResidentResident
sectionstringSection under which the tax is deducted for the deductee195
codestringCode under which the tax is deducted for deductee.195
categorystringCategory under which tax is deducted for deductee.Others
nature_of_paymentstringThe kind of payment being made. Cargo Handling Services Inspection And Logistics Services
credit_amountnumPayment amount (in INR)250000
credit_datestringDate of payment
Format: DD/MM/YYYY
20/02/2021
tds_ratenumApplicable TDS rate7.5
threshold_amountnumThreshold amount that could be deducted2500
due_datestringDue date of depositing TDS07/03/2021
tds_amountnumTDS amount to be deducted18750

Response Caching

Response caching is not available for this API. Learn more about our response caching mechanism here

Wallet Charges

Since TDS Calculator API is not a Paid API, no wallet charge will take place.

Versioning

This API is currently in major version 1.0. Refer to our versioning policies here

Nature of Payments

Serial Numbernature_of_payment (to be passed as below)
1Interest on Securities
2Dividend
3Other Interest
4Processing Charges Paid To NBFC
5Winning From Horse Races
6Winning From Lotteries, Crossword Puzzles, Card Games And Other Games Of Any Sort
7Tender Fees
8Sales And Marketing Services
9Telecasting Services
10Charter Hire Charges (Shipping)
11Advertisement Fee
12AMC Charges
13Bandwidth Charges
14Cargo Handling Services Inspection And Logistics Services
15Clearing And Forwarding Charges
16Fabrication Services
17Freight Charges
18Income From Shipping, Inland Waterways, Or Air Transport
19Sponsorship Fees
20Retention Fees
21Installation And Commissioning Services
22Warranty Services
23Drilling
24Insurance Commission
25Withdrawal From NSS Deposit
26Payment For Repurchase Of Units By UTI Or MF
27Commission On Sale Of Lottery Tickets
28Other Commissions
29Brokerage
30Equipment Rental Charges
31Lease And Rental Payment
32Fees For Technical Services
33Seismic Data Processing
34Software Licences
35Architectural Services
36Consulting Services
37Designing Fee
38Directors Fees
39Engineering Services
40Licensing Fee
41Payments To Sports Person And Artists
42Professional Services
43Processing Charges Paid To Others
44Purchase Of Software
45R & D Charges
46Retainership Fees
47Royalty
48Payments To Students Or Business Apprentice
49Subscription Fees (Other Than Membership Fees Or Sale Of Goods)
50Supervision Charges
51Testing Charges
52Training
53Payment For Compulsory Acquisition Of Immovable Properties
54Payment In Respect Of Life Insurance Policy
55Sale Of Immovable Property
56Payment of Accumulated Balance of Provident Fund
57Income in respect of units of investment fund
58Income In Respect Of Investment In Securitization Trust
59Payment for Development Agreement
60Ltcg Referred To In Section 112(1)(C) (Iii) Or 112A
61Ltcg Other Than Referred To In Section 112(1)(C) (Iii) Or 112A
62Stcg From Shares And Securities Referred To In Section 111A
63Income From The Investment Made By Nri Citizen
64Income By Way Of Royalty
65Fees For Technical Service
66Income By Way Of Interest (Other Than Interest Income Referred In Section 194Lb Or Section 194Lc)
67Any Other Sum Payable To Non Resident
68Participation In Games By Sportsmen
69Advertisement By Sportsmen
70Any Performance In India By Sportsmen
71Contribution Of Articles Relating To Any Game Or Sport In India
72Income In Respect Of Units Of Non Residents
73Payments In Respect Of Units To An Offshore Fund
74Income From Foreign Currency Bonds Or Shares Of Indian Company Payable To Non Resident
75Income Of Foreign Institutional Investors From Securities
76Interest Payment On Infrastructure Debt Fund
77Interest Payment From Indian Company Or Business Trust
78Interest Payment On Bonds And Government Securities
79Cash Withdrawal Exceeding 20 Lacs
80Interest From Mutual Funds
81Interest Payment From Units Of A Business Trust
82Dividend Payment From Units Of A Business Trust
83Cash Withdrawal Exceeding 1 Crore
84Payment For E-Commerce Transactions
85Rental Income From Units Of A Business Trust
86Prequisites Or Benefits Allowed To Distributors Or Agents
87Payment For Transfer Of Virtual Digital Assets