Calculate TDS

Request parameters - Information

Parameters

Required

Description

deductee_type

Yes

Type of Deductee Possible Values:

Individual, HUF, Company,

Firm, Trust

is_pan_available

Yes

Is PAN of deductee available?

Possible Values: Y, N

residential_status

Yes

Residential Status of the user

Possible Values:

Resident, Non Resident

section

Yes

Section under which the tax is

deducted for deductee

credit_amount

Yes

Payment amount (in INR)

credit_date

Yes

Date of payment

Format: DD/MM/YYYY

Response structure - Information

Response

Description

code

Sucess or failure code

timestamp

Time of when calculation was conducted

transaction_id

Transaction id of the calculation

deductee_type

Type of Deductee Possible Values:

Individual, HUF, Company,

Firm, or Trust

is_pan_available

Returns Y or N.

residential_status

Residential Status of the user

Possible Values:

Resident, Non Resident

section

Section under which the tax is

deducted for deductee

credit_amount

Payment amount (in INR)

credit_date

Date of payment

Format: DD/MM/YYYY

tds_rate

Applicable TDS rate

threshold_amount

Threshold amount that could be deducted

due_date

Due date of filing TDS

tds_amount

TDS amount to be deducted

post
Calculate TDS

https://api.sandbox.co.in/calculators/tds
Calculate TDS according to section, deductee, salary amount, and date of payment.
Request
Response
Request
Headers
Authorization
required
string
JWT Authorization token
x-api-key
required
string
Public key required to authorize API access
x-api-version
optional
string
Content-Type
optional
string
application/json
Body Parameters
deductee_type
required
string
Type of Deductee Possible Values: Individual, HUF, Company, Firm, Trust
is_pan_available
required
string
Is PAN of deductee available or not Possible Values: Y, N
residential_status
required
string
Residential Status Possible Values: Resident, Non Resident
section
required
string
Section under which tax is deducted for deductee
credit_amount
required
number
Payment amount (in INR)
credit_date
required
string
Date of payment Format: DD/MM/YYYY
Response
200: OK
{
"code": 200,
"timestamp": 1616223746147,
"transaction_id": "f24cd229-42c8-43de-af79-8ce2d3c4c3db",
"data": {
"deductee_type": "Individual",
"is_pan_available": "Y",
"residential_status": "Resident",
"section": "194 - Dividend",
"credit_amount": 250000,
"credit_date": "20/02/2021",
"tds_rate": 7.5,
"threshold_amount": 2500,
"due_date": "07/03/2021",
"tds_amount": 18750
}
}

The list of sections are mentioned in TDS Annexure

Body Raw

{
"deductee_type": "Individual",
"is_pan_available": "Y",
"residential_status": "Resident",
"section": "194 - Dividend",
"credit_amount": 250000,
"credit_date": "20/02/2021"
}

Example Request

cURL
Java
Node.js
Python
cURL
curl --location --request POST 'https://api.sandbox.co.in/calculators/tds' \
--header 'Authorization: ACCESS_TOKEN' \
--header 'x-api-key: API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"deductee_type": "Individual",
"is_pan_available": "Y",
"residential_status": "Resident",
"section": "194 - Dividend",
"credit_amount": 250000,
"credit_date": "20/02/2021"
}'
Java
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n \"deductee_type\": \"Individual\",\r\n \"is_pan_available\": \"Y\",\r\n \"residential_status\": \"Resident\",\r\n \"section\": \"194 - Dividend\",\r\n \"credit_amount\": 250000,\r\n \"credit_date\": \"20/02/2021\"\r\n}");
Request request = new Request.Builder()
.url("https://api.sandbox.co.in/calculators/tds")
.method("POST", body)
.addHeader("Authorization", "ACCESS_TOKEN")
.addHeader("x-api-key", "API_KEY")
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
Node.js
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.sandbox.co.in/calculators/tds',
'headers': {
'Authorization': 'ACCESS_TOKEN',
'x-api-key': 'API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({"deductee_type":"Individual","is_pan_available":"Y","residential_status":"Resident","section":"194 - Dividend","credit_amount":250000,"credit_date":"20/02/2021"})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
Python
import requests
url = "https://api.sandbox.co.in/calculators/tds"
payload="{\r\n \"deductee_type\": \"Individual\",\r\n \"is_pan_available\": \"Y\",\r\n \"residential_status\": \"Resident\",\r\n \"section\": \"194 - Dividend\",\r\n \"credit_amount\": 250000,\r\n \"credit_date\": \"20/02/2021\"\r\n}"
headers = {
'Authorization': 'ACCESS_TOKEN',
'x-api-key': 'API_KEY',
'Content-Type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)