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 Method | Endpoint |
---|---|
POST | calculators/tds |
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.
Parameters | Required | Type | Description | Example |
---|---|---|---|---|
deductee_type | Yes | string | Type of Deductee Possible Values: Individual, HUF, Company, Firm, Trust | Individual |
is_pan_available | Yes | string | Is the PAN of the deductee available? Possible Values: Y, N | Y |
residential_status | Yes | string | Residential Status of the user Possible Values: Resident, Non Resident | Resident |
nature_of_payment | Yes | string | Type of the payment being made. Nature of Payments | Cargo Handling Services Inspection And Logistics Services |
credit_amount | Yes | num | Payment amount (in INR) | 250000 |
credit_date | Yes | string | Date 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
Param | Type | Description | Example |
---|---|---|---|
deductee_type | string | Type of Deductee Possible Values: Individual, HUF, Company, Firm, or Trust | Individual |
is_pan_available | string | Returns Y or N. | Y |
residential_status | string | Residential Status of the user. Possible Values: Resident, Non Resident | Resident |
section | string | Section under which the tax is deducted for the deductee | 195 |
code | string | Code under which the tax is deducted for deductee. | 195 |
category | string | Category under which tax is deducted for deductee. | Others |
nature_of_payment | string | The kind of payment being made. | Cargo Handling Services Inspection And Logistics Services |
credit_amount | num | Payment amount (in INR) | 250000 |
credit_date | string | Date of payment Format: DD/MM/YYYY | 20/02/2021 |
tds_rate | num | Applicable TDS rate | 7.5 |
threshold_amount | num | Threshold amount that could be deducted | 2500 |
due_date | string | Due date of depositing TDS | 07/03/2021 |
tds_amount | num | TDS amount to be deducted | 18750 |
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 Number | nature_of_payment (to be passed as below) |
---|---|
1 | Interest on Securities |
2 | Dividend |
3 | Other Interest |
4 | Processing Charges Paid To NBFC |
5 | Winning From Horse Races |
6 | Winning From Lotteries, Crossword Puzzles, Card Games And Other Games Of Any Sort |
7 | Tender Fees |
8 | Sales And Marketing Services |
9 | Telecasting Services |
10 | Charter Hire Charges (Shipping) |
11 | Advertisement Fee |
12 | AMC Charges |
13 | Bandwidth Charges |
14 | Cargo Handling Services Inspection And Logistics Services |
15 | Clearing And Forwarding Charges |
16 | Fabrication Services |
17 | Freight Charges |
18 | Income From Shipping, Inland Waterways, Or Air Transport |
19 | Sponsorship Fees |
20 | Retention Fees |
21 | Installation And Commissioning Services |
22 | Warranty Services |
23 | Drilling |
24 | Insurance Commission |
25 | Withdrawal From NSS Deposit |
26 | Payment For Repurchase Of Units By UTI Or MF |
27 | Commission On Sale Of Lottery Tickets |
28 | Other Commissions |
29 | Brokerage |
30 | Equipment Rental Charges |
31 | Lease And Rental Payment |
32 | Fees For Technical Services |
33 | Seismic Data Processing |
34 | Software Licences |
35 | Architectural Services |
36 | Consulting Services |
37 | Designing Fee |
38 | Directors Fees |
39 | Engineering Services |
40 | Licensing Fee |
41 | Payments To Sports Person And Artists |
42 | Professional Services |
43 | Processing Charges Paid To Others |
44 | Purchase Of Software |
45 | R & D Charges |
46 | Retainership Fees |
47 | Royalty |
48 | Payments To Students Or Business Apprentice |
49 | Subscription Fees (Other Than Membership Fees Or Sale Of Goods) |
50 | Supervision Charges |
51 | Testing Charges |
52 | Training |
53 | Payment For Compulsory Acquisition Of Immovable Properties |
54 | Payment In Respect Of Life Insurance Policy |
55 | Sale Of Immovable Property |
56 | Payment of Accumulated Balance of Provident Fund |
57 | Income in respect of units of investment fund |
58 | Income In Respect Of Investment In Securitization Trust |
59 | Payment for Development Agreement |
60 | Ltcg Referred To In Section 112(1)(C) (Iii) Or 112A |
61 | Ltcg Other Than Referred To In Section 112(1)(C) (Iii) Or 112A |
62 | Stcg From Shares And Securities Referred To In Section 111A |
63 | Income From The Investment Made By Nri Citizen |
64 | Income By Way Of Royalty |
65 | Fees For Technical Service |
66 | Income By Way Of Interest (Other Than Interest Income Referred In Section 194Lb Or Section 194Lc) |
67 | Any Other Sum Payable To Non Resident |
68 | Participation In Games By Sportsmen |
69 | Advertisement By Sportsmen |
70 | Any Performance In India By Sportsmen |
71 | Contribution Of Articles Relating To Any Game Or Sport In India |
72 | Income In Respect Of Units Of Non Residents |
73 | Payments In Respect Of Units To An Offshore Fund |
74 | Income From Foreign Currency Bonds Or Shares Of Indian Company Payable To Non Resident |
75 | Income Of Foreign Institutional Investors From Securities |
76 | Interest Payment On Infrastructure Debt Fund |
77 | Interest Payment From Indian Company Or Business Trust |
78 | Interest Payment On Bonds And Government Securities |
79 | Cash Withdrawal Exceeding 20 Lacs |
80 | Interest From Mutual Funds |
81 | Interest Payment From Units Of A Business Trust |
82 | Dividend Payment From Units Of A Business Trust |
83 | Cash Withdrawal Exceeding 1 Crore |
84 | Payment For E-Commerce Transactions |
85 | Rental Income From Units Of A Business Trust |
86 | Prequisites Or Benefits Allowed To Distributors Or Agents |
87 | Payment For Transfer Of Virtual Digital Assets |
Updated 5 months ago