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.

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 EndpointAPI Endpoint

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

Nature of Payments

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