Skip to main content
POST
/
tcs
/
calculator
Calculate TCS on Payments
curl --request POST \
  --url https://api.sandbox.co.in/tcs/calculator \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "@entity": "in.co.sandbox.tcs.calculator.request",
  "collectee_type": "<string>",
  "is_pan_available": true,
  "residential_status": "<string>",
  "is_206cca_applicable": true,
  "is_pan_operative": true,
  "nature_of_payment": "<string>",
  "payment_amount": 123,
  "payment_date": 123
}'
{
  "code": 200,
  "timestamp": 1685577600000,
  "transaction_id": "1eff4b29-c622-4486-8981-7caaea822e3d",
  "data": {
    "@entity": "in.co.sandbox.tcs.calculator.response",
    "collectee_type": "individual",
    "is_pan_available": true,
    "is_206cca_applicable": true,
    "is_pan_operative": true,
    "residential_status": "resident",
    "section": "206C(1G)",
    "code": "6CQ",
    "category": "remittance_under_lrs_for_purpose_other_than_for_purchase_of_overseas_tour_package_or_for_education_loan_taken_from_financial_institution_mentioned_under_section_80e",
    "nature_of_payment": "foreign_remittance_for_other_purposes",
    "payment_amount": 895345,
    "payment_date": 1708926739000,
    "collection_rate": 20,
    "threshold_amount": 700000,
    "due_date": 1709749800000,
    "collection_amount": 39069
  }
}

Headers

ā€‹
x-api-key
string
required

API key for identification

ā€‹
Authorization
string
required

JWT access token

ā€‹
x-api-version
string

API Version

Body

application/json
ā€‹
@entity
enum<string>
required
Available options:
in.co.sandbox.tcs.calculator.request
ā€‹
collectee_type
string
required

Type of Collectee Possible Values: individual, huf, company, firm, trust, local_authority, body_of_individuals, association_of_persons, artificial_judicial_person

ā€‹
is_pan_available
boolean
required

Is the PAN available with the deductee? Possible Values: true, or false,

ā€‹
residential_status
string
required

Residential Status of the deductee. Possible Values: resident or non_resident

ā€‹
is_206cca_applicable
boolean
required

Whether the deductee is a specified person u/s 206cca. Possible Values: true or false

ā€‹
is_pan_operative
boolean
required

Whether the PAN of the deductee is Operative. Possible Values: true or false

ā€‹
nature_of_payment
string
required

Type of the payment being collected. Refer to Nature of payments for enums

ā€‹
payment_amount
number
required

Payment amount inclusive of GST (in INR)

ā€‹
payment_date
number
required

Date of payment in EPOCH

Response

200 - OK

ā€‹
code
integer
ā€‹
timestamp
integer
ā€‹
transaction_id
string
ā€‹
data
object