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
Show child attributes
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Sandbox","description":"End-to-end tax automation platform for businesses to verify tax ids, calculate \u0026 pay taxes, generate e-invoices, process tax documents, analyse \u0026 reconcile tax ledgers, prepare and file tax returns through SDKs \u0026 APIs.","colors":{"primary":"#151455","light":"#CFCEFF","dark":"#1B1B20"},"logo":{"light":"https://mintcdn.com/in-co-sandbox/83aihwHbv0_fbS-u/static/logo/light.svg?fit=max\u0026auto=format\u0026n=83aihwHbv0_fbS-u\u0026q=85\u0026s=83271c8bdbc5e5c9585f979d9a278d59","dark":"https://mintcdn.com/in-co-sandbox/83aihwHbv0_fbS-u/static/logo/dark.svg?fit=max\u0026auto=format\u0026n=83aihwHbv0_fbS-u\u0026q=85\u0026s=179fdab40936062e350c9197e38ddf85","href":"https://developer.sandbox.co.in/"},"favicon":{"light":"https://mintcdn.com/in-co-sandbox/83aihwHbv0_fbS-u/static/favicon/light.svg?fit=max\u0026auto=format\u0026n=83aihwHbv0_fbS-u\u0026q=85\u0026s=11228c94a2f4982dc5e2b54c24501858","dark":"https://mintcdn.com/in-co-sandbox/83aihwHbv0_fbS-u/static/favicon/dark.svg?fit=max\u0026auto=format\u0026n=83aihwHbv0_fbS-u\u0026q=85\u0026s=3b7eaa27875373c8d3882169bf79874e"},"api":{"examples":{"prefill":true}},"background":{"decoration":"gradient"},"navbar":{"links":[{"icon":"life-ring","href":"https://help.sandbox.co.in/","label":"Help Centre"},{"icon":"phone","href":"https://sandbox.co.in/contact-sales","label":"Contact Sales"}],"primary":{"type":"button","label":"Sign Up","href":"https://accounts.sandbox.co.in/signup"}},"footer":{"socials":{"github":"https://github.com/in-co-sandbox","linkedin":"https://www.linkedin.com/showcase/sandboxapi","medium":"https://medium.com/blog-by-sandbox","youtube":"https://www.youtube.com/@sandboxapi","x":"https://twitter.com/sandbox_api"}},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"gtm":{"tagId":"GTM-NWRF32W"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"in-co-sandbox","hasAudioNarration":false,"actualSubdomain":"in-co-sandbox","customDomains":["developer.sandbox.co.in"],"gitSource":{"type":"github","owner":"company-quicko","repo":"in-co-sandbox","deployBranch":"main","contentDirectory":"in-co-sandbox-docs","isPrivate":true,"mountPath":"","label":"","_id":"6adf43f8a6cc13f54cfb5698"},"entitlements":{},"buildId":"6af92a08df163b1980473211","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"API Reference","count":359},{"language":"default","tag":"GST","count":201},{"language":"default","tag":"Compliance","count":201},{"language":"default","tag":"Taxpayer","count":117},{"language":"default","tag":"TDS","count":89},{"language":"default","tag":"Income Tax","count":57},{"language":"default","tag":"KYC","count":54},{"language":"default","tag":"Calculator","count":44},{"language":"default","tag":"Tax P\u0026L","count":41},{"language":"default","tag":"E-Way Bill","count":40}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs{display:flex;align-items:center;justify-content:flex-start;width:100%}.nav-tabs>.nav-tabs-item:not(:has(~.nav-tabs-item)){margin-left:auto!important}img.icon,a img.icon,img[class*=\"icon\"],a img[class*=\"icon\"],img[class*=\"bg-\"],a img[class*=\"bg-\"],.card img.icon,.card a img.icon,.nav-dropdown-item-icon img,.nav-dropdown-item-icon a img{background:transparent!important;background-color:transparent!important;box-shadow:none!important}.dark img.icon,.dark a img.icon,body:has(#landing_page_background_div) #header,body:has(#landing_page_background_div) header#header{display:none!important}.dark img[class*=\"bg-\"],.dark a img[class*=\"bg-\"]{background:transparent!important;background-color:transparent!important;box-shadow:none!important}img.icon,a img.icon{padding:0!important;border-radius:0!important}div:has(>div>div>div>#landing_page_background_div){width:100%;height:100%;background:url('/static/svg/landing/bg-pattern-light.svg');background-size:contain;background-repeat:no-repeat}.dark div:has(>div>div>div>#landing_page_background_div){background:url('/static/svg/landing/bg-pattern.svg');background-size:contain;background-repeat:no-repeat}"}],"page":{"pagePath":"api-reference/tds/calculator/tcs-calculator/endpoints/calculator","slug":"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator","pageMetadata":{"title":"Calculate TCS","description":"Calculate TCS collectible on payments by providing the relevant details.","openapi":"api-reference/tds/calculator/openapi.json POST /tcs/calculator","href":"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Calculate TCS collectible on payments by providing the relevant details.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Calculate TCS","description":"Calculate TCS collectible on payments by providing the relevant details.","openapi":"api-reference/tds/calculator/openapi.json POST /tcs/calculator","href":"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Calculate TCS on Payments","tags":["TCS Payments"],"parameters":["e815a176-eebc-484e-96ac-58e133e9e5d2","a9ac4700-fc06-41c2-bbcb-8ddfdd6232d1","7903f15f-a739-48fa-ab46-daacb2c7b991"],"responses":{"200":"b4f2784a-7ecb-4891-b510-a5816177d008","400":"1f93bcab-7f55-49d9-a353-d141f703a84b","422":"f33f06ab-1c31-4638-93f4-71df168c6b77","500":"2620b3d1-c1d5-4fa6-adde-d36dedc9cff7"},"requestBody":"bc57639d-dd0a-4fa5-a0d8-a50e922606b4","method":"post","type":"path","servers":["955a8cea-f7c6-4f18-b432-15854607e6b7","fc883977-ea47-4a83-b166-328d47a34180"],"security":[],"path":"/tcs/calculator","baseUrlOptions":["https://test-api.sandbox.co.in","https://api.sandbox.co.in"],"title":"Calculate TCS on Payments","description":"Calculate TCS collectible on payments by providing the relevant details.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":true,"body.residential_status":"resident","body.is_206cca_applicable":true,"body.is_pan_operative":true,"body.nature_of_payment":"foreign_remittance_for_other_purposes","body.payment_amount":895345,"body.payment_date":1708926739000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":true,"body.residential_status":"resident","body.is_206cca_applicable":true,"body.is_pan_operative":true,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":775000,"body.payment_date":1698777000000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"company","body.is_pan_available":true,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":true,"body.nature_of_payment":"sale_of_motor_vehicle","body.payment_amount":1250000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":true,"body.residential_status":"resident","body.is_206cca_applicable":true,"body.is_pan_operative":true,"body.nature_of_payment":"sale_of_tendu_leaves","body.payment_amount":500000,"body.payment_date":1706639400000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":true,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":true,"body.nature_of_payment":"sale_of_goods","body.payment_amount":4500000,"body.payment_date":1707244200000},{"body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"person","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"foreigner","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.payment_amount":695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":-695000,"body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_date":1685577600000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"foreign_flight_tickets","body.payment_amount":695000},{"body.@entity":"in.co.sandbox.tcs.calculator.request","body.collectee_type":"individual","body.is_pan_available":false,"body.residential_status":"resident","body.is_206cca_applicable":false,"body.is_pan_operative":false,"body.nature_of_payment":"tender_fees","body.payment_amount":695000,"body.payment_date":1685577600000}]},"dependencies":{"parameters":{"e815a176-eebc-484e-96ac-58e133e9e5d2":{"name":"x-api-key","in":"header","required":true,"description":"API key for identification","deprecated":false,"schema":{"type":"string","isRequired":true,"description":"API key for identification","uniqueKey":"","typeLabel":"string"}},"a9ac4700-fc06-41c2-bbcb-8ddfdd6232d1":{"name":"authorization","in":"header","required":true,"description":"JWT access token","deprecated":false,"schema":{"type":"string","isRequired":true,"description":"JWT access token","uniqueKey":"","typeLabel":"string"}},"7903f15f-a739-48fa-ab46-daacb2c7b991":{"name":"x-api-version","in":"header","description":"API Version","schema":{"type":"string","description":"API Version","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"@entity":{"type":"string","enum":["in.co.sandbox.tcs.calculator.request"],"isRequired":true,"uniqueKey":"@entity","typeLabel":"enum\u003cstring>"},"collectee_type":{"description":"Type of Collectee Possible Values: individual, huf, company, firm, trust, local_authority, body_of_individuals, association_of_persons, artificial_judicial_person","type":"string","isRequired":true,"uniqueKey":"collectee_type","typeLabel":"string"},"is_pan_available":{"description":"Is the PAN available with the deductee? Possible Values: true, or false,","type":"boolean","isRequired":true,"uniqueKey":"is_pan_available","typeLabel":"boolean"},"residential_status":{"type":"string","description":"Residential Status of the deductee. Possible Values: resident or non_resident","isRequired":true,"uniqueKey":"residential_status","typeLabel":"string"},"is_206cca_applicable":{"type":"boolean","description":"Whether the deductee is a specified person u/s 206cca. Possible Values: true or false","isRequired":true,"uniqueKey":"is_206cca_applicable","typeLabel":"boolean"},"is_pan_operative":{"description":"Whether the PAN of the deductee is Operative. Possible Values: true or false","type":"boolean","isRequired":true,"uniqueKey":"is_pan_operative","typeLabel":"boolean"},"nature_of_payment":{"description":"Type of the payment being collected. Refer to Nature of payments for enums","type":"string","isRequired":true,"uniqueKey":"nature_of_payment","typeLabel":"string"},"payment_amount":{"description":"Payment amount inclusive of GST (in INR)","type":"number","isRequired":true,"uniqueKey":"payment_amount","typeLabel":"number"},"payment_date":{"description":"Date of payment in EPOCH","type":"number","isRequired":true,"uniqueKey":"payment_date","typeLabel":"number"}},"required":["@entity","collectee_type","is_pan_available","residential_status","is_206cca_applicable","is_pan_operative","nature_of_payment","payment_amount","payment_date"],"uniqueKey":"","typeLabel":"object"},"examples":{"200 - Success":{"title":"200 - Success","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":true,"residential_status":"resident","is_206cca_applicable":true,"is_pan_operative":true,"nature_of_payment":"foreign_remittance_for_other_purposes","payment_amount":895345,"payment_date":1708926739000}},"200 TCS Calculated for 206C(1G)":{"title":"200 TCS Calculated for 206C(1G)","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":true,"residential_status":"resident","is_206cca_applicable":true,"is_pan_operative":true,"nature_of_payment":"foreign_flight_tickets","payment_amount":775000,"payment_date":1698777000000}},"200 TCS Calculated for 206C(1F)":{"title":"200 TCS Calculated for 206C(1F)","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"company","is_pan_available":true,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":true,"nature_of_payment":"sale_of_motor_vehicle","payment_amount":1250000,"payment_date":1685577600000}},"200 TCS Calculated for 206C(1)":{"title":"200 TCS Calculated for 206C(1)","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":true,"residential_status":"resident","is_206cca_applicable":true,"is_pan_operative":true,"nature_of_payment":"sale_of_tendu_leaves","payment_amount":500000,"payment_date":1706639400000}},"200 TCS Calculated for 206C(1H)":{"title":"200 TCS Calculated for 206C(1H)","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":true,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":true,"nature_of_payment":"sale_of_goods","payment_amount":4500000,"payment_date":1707244200000}},"400 Request body not valid":{"title":"400 Request body not valid","value":{"collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Missing collectee type":{"title":"422 Missing collectee type","value":{"@entity":"in.co.sandbox.tcs.calculator.request","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Invalid collectee type":{"title":"422 Invalid collectee type","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"person","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Missing pan available":{"title":"422 Missing pan available","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Missing residential status":{"title":"422 Missing residential status","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Invalid residential status":{"title":"422 Invalid residential status","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"foreigner","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000,"payment_date":1685577600000}},"422 Missing nature of payment":{"title":"422 Missing nature of payment","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"payment_amount":695000,"payment_date":1685577600000}},"422 Payment amount cannot be negative":{"title":"422 Payment amount cannot be negative","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":-695000,"payment_date":1685577600000}},"422 Missing purchase amount":{"title":"422 Missing purchase amount","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_date":1685577600000}},"422 Missing payment date":{"title":"422 Missing payment date","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"foreign_flight_tickets","payment_amount":695000}},"500 Reference data not found":{"title":"500 Reference data not found","value":{"@entity":"in.co.sandbox.tcs.calculator.request","collectee_type":"individual","is_pan_available":false,"residential_status":"resident","is_206cca_applicable":false,"is_pan_operative":false,"nature_of_payment":"tender_fees","payment_amount":695000,"payment_date":1685577600000}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"b4f2784a-7ecb-4891-b510-a5816177d008":{"description":"200 - OK","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","uniqueKey":"code","typeLabel":"integer"},"timestamp":{"type":"integer","uniqueKey":"timestamp","typeLabel":"integer"},"transaction_id":{"type":"string","uniqueKey":"transaction_id","typeLabel":"string"},"data":{"type":"object","properties":{"@entity":{"type":"string","uniqueKey":"data.@entity","typeLabel":"string"},"collectee_type":{"type":"string","uniqueKey":"data.collectee_type","typeLabel":"string"},"is_pan_available":{"type":"boolean","uniqueKey":"data.is_pan_available","typeLabel":"boolean"},"is_206cca_applicable":{"type":"boolean","uniqueKey":"data.is_206cca_applicable","typeLabel":"boolean"},"is_pan_operative":{"type":"boolean","uniqueKey":"data.is_pan_operative","typeLabel":"boolean"},"residential_status":{"type":"string","uniqueKey":"data.residential_status","typeLabel":"string"},"section":{"type":"string","uniqueKey":"data.section","typeLabel":"string"},"code":{"type":"string","uniqueKey":"data.code","typeLabel":"string"},"category":{"type":"string","uniqueKey":"data.category","typeLabel":"string"},"nature_of_payment":{"type":"string","uniqueKey":"data.nature_of_payment","typeLabel":"string"},"payment_amount":{"type":"integer","uniqueKey":"data.payment_amount","typeLabel":"integer"},"payment_date":{"type":"integer","uniqueKey":"data.payment_date","typeLabel":"integer"},"collection_rate":{"type":"integer","uniqueKey":"data.collection_rate","typeLabel":"integer"},"threshold_amount":{"type":"integer","uniqueKey":"data.threshold_amount","typeLabel":"integer"},"due_date":{"type":"integer","uniqueKey":"data.due_date","typeLabel":"integer"},"collection_amount":{"type":"integer","uniqueKey":"data.collection_amount","typeLabel":"integer"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"200 - Success":{"title":"200 - Success","value":{"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}}},"200 TCS Calculated for 206C(1G)":{"title":"200 TCS Calculated for 206C(1G)","value":{"code":200,"timestamp":1763633943000,"transaction_id":"db11de65-e36a-4b7a-ba7a-6590cabe5154","data":{"@entity":"in.co.sandbox.tcs.calculator.response","deductee_type":"individual","is_pan_available":true,"is_206cca_applicable":true,"is_pan_operative":true,"residential_status":"resident","section":"206C(1G)","code":"6CO","category":"overseas_tour_program_package","nature_of_payment":"foreign_flight_tickets","payment_amount":775000,"payment_date":1698777000000,"collection_rate":20,"threshold_amount":700000,"due_date":1701887400000,"collection_amount":15000}}},"200 TCS Calculated for 206C(1F)":{"title":"200 TCS Calculated for 206C(1F)","value":{"code":200,"timestamp":1763633943000,"transaction_id":"5f196dde-6e2c-4b73-8cc2-70ae87c51e66","data":{"@entity":"in.co.sandbox.tcs.calculator.response","deductee_type":"individual","is_pan_available":true,"is_206cca_applicable":false,"is_pan_operative":true,"residential_status":"resident","section":"206C(1F)","code":"6CL","category":"motor_vehicle_any_mode_of_payment","nature_of_payment":"sale_of_motor_vehicle","payment_amount":1250000,"payment_date":1685577600000,"collection_rate":1,"threshold_amount":1000000,"due_date":1688668200000,"collection_amount":12500}}},"200 TCS Calculated for 206C(1)":{"title":"200 TCS Calculated for 206C(1)","value":{"code":200,"timestamp":1763633943000,"transaction_id":"c01778c3-a3f8-4f4b-863d-907f2d91b49c","data":{"@entity":"in.co.sandbox.tcs.calculator.response","deductee_type":"individual","is_pan_available":true,"is_206cca_applicable":true,"is_pan_operative":true,"residential_status":"resident","section":"206C(1)","code":"6CI","category":"tendu_leaves","nature_of_payment":"sale_of_tendu_leaves","payment_amount":500000,"payment_date":1706639400000,"collection_rate":5,"threshold_amount":0,"due_date":1707244200000,"collection_amount":25000}}},"200 TCS Calculated for 206C(1H)":{"title":"200 TCS Calculated for 206C(1H)","value":{"code":200,"timestamp":1763633943000,"transaction_id":"5c282d5f-2635-46c9-a299-9d529bab01c3","data":{"@entity":"in.co.sandbox.tcs.calculator.response","deductee_type":"company","is_pan_available":true,"is_206cca_applicable":false,"is_pan_operative":true,"residential_status":"resident","section":"206C(1H)","code":"6CR","category":"sale_of_goods","nature_of_payment":"sale_of_goods","payment_amount":4500000,"payment_date":1707244200000,"collection_rate":0.1,"threshold_amount":5000000,"due_date":1709749800000,"collection_amount":0}}}},"exampleType":"examples"}},"exampleType":"examples"},"1f93bcab-7f55-49d9-a353-d141f703a84b":{"description":"400 - Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"transaction_id":{"type":"string","uniqueKey":"transaction_id","typeLabel":"string"},"code":{"type":"integer","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"integer","uniqueKey":"timestamp","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"400 Request body not valid":{"title":"400 Request body not valid","value":{"transaction_id":"b19fb5c2-b88d-4436-b226-d388d9a01740","code":400,"message":"Request body not valid","timestamp":1703168424000}}},"exampleType":"examples"}},"exampleType":"examples"},"f33f06ab-1c31-4638-93f4-71df168c6b77":{"description":"422 - Unprocessable Entity","content":{"application/json":{"schema":{"type":"object","properties":{"transaction_id":{"type":"string","uniqueKey":"transaction_id","typeLabel":"string"},"code":{"type":"integer","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"integer","uniqueKey":"timestamp","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"422 Missing collectee type":{"title":"422 Missing collectee type","value":{"transaction_id":"28c46f8c-fffb-40cf-b917-0b496feb36b4","code":422,"message":"Missing collectee type","timestamp":1703168441000}},"422 Invalid collectee type":{"title":"422 Invalid collectee type","value":{"transaction_id":"5139807c-9f9c-4e87-83b7-4d60ce0c8ac0","code":422,"message":"Invalid collectee type","timestamp":1703168454000}},"422 Missing pan available":{"title":"422 Missing pan available","value":{"transaction_id":"6616acff-34c0-4c73-b526-5715a8a79069","code":422,"message":"Missing pan available","timestamp":1703168467000}},"422 Missing residential status":{"title":"422 Missing residential status","value":{"transaction_id":"cb7c414d-1df3-47d9-a284-14598f82d78b","code":422,"message":"Missing residential status","timestamp":1703168499000}},"422 Invalid residential status":{"title":"422 Invalid residential status","value":{"transaction_id":"598587c6-a5ae-43d3-b2a5-c050afdf5b99","code":422,"message":"Invalid residential status","timestamp":1703168517000}},"422 Missing nature of payment":{"title":"422 Missing nature of payment","value":{"transaction_id":"a2d8cc6c-3af4-4b7e-9848-9283353e3a31","code":422,"message":"Missing nature of payment","timestamp":1703170833000}},"422 Payment amount cannot be negative":{"title":"422 Payment amount cannot be negative","value":{"transaction_id":"97c41038-162e-49a7-8bb2-d8b64542f0bf","code":422,"message":"payment amount cannot be negative","timestamp":1703170878000}},"422 Missing purchase amount":{"title":"422 Missing purchase amount","value":{"transaction_id":"70490c3b-477f-4537-b5cb-44ba7d9b612a","code":422,"message":"Missing payment amount","timestamp":1703170910000}},"422 Missing payment date":{"title":"422 Missing payment date","value":{"transaction_id":"8d6f398b-0afe-4303-944e-023673a65151","code":422,"message":"Missing payment date","timestamp":1703170938000}}},"exampleType":"examples"}},"exampleType":"examples"},"2620b3d1-c1d5-4fa6-adde-d36dedc9cff7":{"description":"500 - Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"transaction_id":{"type":"string","uniqueKey":"transaction_id","typeLabel":"string"},"code":{"type":"integer","uniqueKey":"code","typeLabel":"integer"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"integer","uniqueKey":"timestamp","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"examples":{"500 Reference data not found":{"title":"500 Reference data not found","value":{"transaction_id":"03e35453-dcec-4b33-a9dc-0c4714c9efba","code":500,"message":"Reference data not found","timestamp":1703170954000}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"955a8cea-f7c6-4f18-b432-15854607e6b7":{"url":"https://test-api.sandbox.co.in"},"fc883977-ea47-4a83-b166-328d47a34180":{"url":"https://api.sandbox.co.in"}}},"originalFileLocation":"api-reference/tds/calculator/openapi.json"},"subdomain":"in-co-sandbox","siteName":"Sandbox","title":"Calculate TCS - Sandbox","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T12:14:58.845Z","originalFileLocation":"api-reference/tds/calculator/tcs-calculator/endpoints/calculator.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Calculate TCS collectible on payments by providing the relevant details.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sandbox\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Calculate TCS - Sandbox\">\u003cmeta data-mint-head property=\"og:description\" content=\"Calculate TCS collectible on payments by providing the relevant details.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sandbox\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://in-co-sandbox.mintlify.site/_mintlify/api/og/v2?division=TCS\u0026amp;title=Calculate+TCS\u0026amp;description=Calculate+TCS+collectible+on+payments+by+providing+the+relevant+details.\u0026amp;theme=df0fa091765a33c812179186\u0026amp;signature=3827dda1ba0cbe6eecfae1ba32e811d6bbb43102e9cc5e0f06c6ee4f65e04236\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Calculate TCS - Sandbox\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Calculate TCS collectible on payments by providing the relevant details.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://in-co-sandbox.mintlify.site/_mintlify/api/og/v2?division=TCS\u0026amp;title=Calculate+TCS\u0026amp;description=Calculate+TCS+collectible+on+payments+by+providing+the+relevant+details.\u0026amp;theme=df0fa091765a33c812179186\u0026amp;signature=3827dda1ba0cbe6eecfae1ba32e811d6bbb43102e9cc5e0f06c6ee4f65e04236\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/in-co-sandbox/1vAiCQMOtoIXdhlB/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sandbox\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#151455\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.sandbox.co.in/#organization\",\"name\":\"Sandbox\",\"url\":\"https://developer.sandbox.co.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/in-co-sandbox/83aihwHbv0_fbS-u/static/logo/light.svg?fit=max\u0026auto=format\u0026n=83aihwHbv0_fbS-u\u0026q=85\u0026s=83271c8bdbc5e5c9585f979d9a278d59\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.sandbox.co.in#website\",\"name\":\"Sandbox\",\"url\":\"https://developer.sandbox.co.in\",\"publisher\":{\"@id\":\"https://developer.sandbox.co.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator#webpage\",\"url\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator\",\"name\":\"Calculate TCS\",\"description\":\"Calculate TCS collectible on payments by providing the relevant details.\",\"dateModified\":\"2026-10-26T12:14:58.845Z\",\"isPartOf\":{\"@id\":\"https://developer.sandbox.co.in#website\"},\"breadcrumb\":{\"@id\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Calculator\",\"item\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Calculate TCS\",\"item\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator#apireference\",\"headline\":\"Calculate TCS\",\"name\":\"Calculate TCS\",\"description\":\"Calculate TCS collectible on payments by providing the relevant details.\",\"url\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator\",\"mainEntityOfPage\":{\"@id\":\"https://developer.sandbox.co.in/api-reference/tds/calculator/tcs-calculator/endpoints/calculator#webpage\"},\"dateModified\":\"2026-10-26T12:14:58.845Z\",\"publisher\":{\"@id\":\"https://developer.sandbox.co.in/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.sandbox.co.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sandbox\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sandbox\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator.md","siteName":"Sandbox","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","icon":"code","menu":[{"item":"Authentication","icon":"rocket-vertical","description":"Authenticate and get access to use Sandbox APIs","pages":[{"title":"Authentication","href":"/api-reference/authenticate"}]},{"item":"KYC","icon":"https://mintlify.s3.us-west-1.amazonaws.com/in-co-sandbox/static/svg/workload-icons/KYC.svg","description":"Confirm Identities with confidence","pages":[{"title":"KYC","href":"/api-reference/kyc/overview"}]},{"item":"GST","icon":"https://mintlify.s3.us-west-1.amazonaws.com/in-co-sandbox/static/svg/workload-icons/GST.svg","description":"Simple and Secure GST Compliance","pages":[{"title":"GST","href":"/api-reference/gst/overview"}]},{"item":"TDS","icon":"https://mintlify.s3.us-west-1.amazonaws.com/in-co-sandbox/static/svg/workload-icons/TDS.svg","description":"Automate TDS on Salary \u0026 Non-Salary Payments","pages":[{"title":"TDS APIs","sidebarTitle":"Overview","href":"/api-reference/tds/overview"},{"group":"Calculator","icon":"calculator","pages":[{"title":"Overview","href":"/api-reference/tds/calculator/overview"},{"title":"OpenAPI Spec","url":"https://developer.sandbox.co.in/api-reference/tds/calculator/openapi.json","href":"/api-reference/tds/calculator/openapi-specification"},{"group":"TDS","pages":[{"group":"Salary Payments","pages":[{"title":"Submit Job","openapi":"api-reference/tds/calculator/openapi.json POST /tds/calculator/salary","href":"/api-reference/tds/calculator/tds-calculator/endpoints/submit_job_salary"},{"title":"Poll Job","openapi":"api-reference/tds/calculator/openapi.json GET /tds/calculator/salary","href":"/api-reference/tds/calculator/tds-calculator/endpoints/poll_job_salary"}]},{"title":"Bulk non-salary TDS calculator API","sidebarTitle":"Non-Salary Payments","openapi":"api-reference/tds/calculator/openapi.json POST /tds/calculator/non-salary","href":"/api-reference/tds/calculator/tds-calculator/endpoints/non_salary"},{"title":"Salary Payments","description":"Calculate TDS payable on salary payments by providing the relevant details.","openapi":"api-reference/tds/calculator/openapi.json POST /tds/calculator/salary/sync","href":"/api-reference/tds/calculator/tds-calculator/endpoints/salary_sync"}]},{"group":"TCS","pages":[{"title":"Calculate TCS","openapi":"api-reference/tds/calculator/openapi.json POST /tcs/calculator","href":"/api-reference/tds/calculator/tcs-calculator/endpoints/calculator"}]}]},{"group":"Analytics","icon":"chart-mixed","pages":[{"title":"OpenAPI Spec","url":"https://developer.sandbox.co.in/api-reference/tds/analytics/openapi.json","description":null,"href":"/api-reference/tds/analytics/openapi-specification"},{"group":"TDS","pages":[{"group":"Create Job","pages":[{"title":"Submit Job","openapi":"api-reference/tds/analytics/openapi.json POST /tds/analytics/potential-notices","href":"/api-reference/tds/analytics/tds-analytics/endpoints/submit_job"},{"title":"Non Salary Payments","mode":"wide","href":"/api-reference/tds/analytics/tds-analytics/non_salary_payments"},{"title":"Salary Payments","mode":"wide","href":"/api-reference/tds/analytics/tds-analytics/salary_payments"},{"title":"NRI Payments","mode":"wide","href":"/api-reference/tds/analytics/tds-analytics/nri_payments"}]},{"group":"Poll Job","pages":[{"title":"Poll Job","openapi":"api-reference/tds/analytics/openapi.json GET /tds/analytics/potential-notices","href":"/api-reference/tds/analytics/tds-analytics/endpoints/poll_job"},{"title":"Potential Notices (Form 24Q)","url":"https://docs.google.com/spreadsheets/d/1Sas8qAYyIdQMChJhpkeMFsfrTgZb3k4E/edit?rtpof=true\u0026sd=true\u0026gid=969170328#gid=969170328","href":"/api-reference/tds/analytics/tds-analytics/external-links/form24q_workbook"},{"title":"Potential Notices (Form 26Q)","url":"https://docs.google.com/spreadsheets/d/1caaB08dzgUu3UoJ7gJH4gDXvjPpQ8am0/edit?gid=575764469#gid=575764469","href":"/api-reference/tds/analytics/tds-analytics/external-links/form26q_workbook"},{"title":"Potential Notices (Form 26Q)","url":"https://docs.google.com/spreadsheets/d/1OQgIA2DCLrZLDikvp2MOElo0D8jcbPiW/edit?gid=139758557#gid=139758557","href":"/api-reference/tds/analytics/tds-analytics/external-links/form27q_workbook"}]},{"title":"Fetch Jobs","openapi":"api-reference/tds/analytics/openapi.json POST /tds/analytics/potential-notices/search","href":"/api-reference/tds/analytics/tds-analytics/endpoints/fetch_jobs"}]},{"group":"TCS","pages":[{"group":"Create Job","pages":[{"title":"Submit Job","openapi":"api-reference/tds/analytics/openapi.json POST /tcs/analytics/potential-notices","href":"/api-reference/tds/analytics/tcs-analytics/endpoints/submit_job"},{"title":"TCS Payments","mode":"wide","href":"/api-reference/tds/analytics/tcs-analytics/tcs_payments"}]},{"group":"Poll Job","pages":[{"title":"Poll Job","openapi":"api-reference/tds/analytics/openapi.json GET /tcs/analytics/potential-notices","href":"/api-reference/tds/analytics/tcs-analytics/endpoints/poll_job"},{"title":"Potential Notices (Form 27EQ)","url":"https://docs.google.com/spreadsheets/d/15O4agoktvZ5gfZE7KxlFaLDWIfPPAlAn/edit?gid=114981599#gid=114981599","href":"/api-reference/tds/analytics/tcs-analytics/external-links/form27eq_workbook"}]},{"title":"Fetch Jobs","openapi":"api-reference/tds/analytics/openapi.json POST /tcs/analytics/potential-notices/search","href":"/api-reference/tds/analytics/tcs-analytics/endpoints/fetch_jobs"}]}]},{"group":"Reports","icon":"file-text","pages":[{"title":"Overview","href":"/api-reference/tds/reports/overview"},{"title":"OpenAPI Spec","url":"https://developer.sandbox.co.in/api-reference/tds/reports/openapi.json","href":"/api-reference/tds/reports/openapi-specification"},{"group":"TDS","pages":[{"group":"Create Job","pages":[{"title":"Submit Job","openapi":"api-reference/tds/reports/openapi.json POST /tds/reports/txt","href":"/api-reference/tds/reports/tds-reports/endpoints/submit_job"},{"title":"Non-salary payments","mode":"wide","href":"/api-reference/tds/reports/tds-reports/non_salary_payments"},{"title":"Salary payments","mode":"wide","href":"/api-reference/tds/reports/tds-reports/salary_payments"},{"title":"NRI payments","mode":"wide","href":"/api-reference/tds/reports/tds-reports/nri_payments"}]},{"title":"Poll Job","openapi":"api-reference/tds/reports/openapi.json GET /tds/reports/txt","href":"/api-reference/tds/reports/tds-reports/endpoints/poll_job"},{"title":"Job status webhook","openapi":"api-reference/tds/reports/openapi.json webhook TDSReportsJobStatus","href":"/api-reference/tds/reports/tds-reports/endpoints/webhook"},{"title":"Fetch Jobs","openapi":"api-reference/tds/reports/openapi.json POST /tds/reports/txt/search","href":"/api-reference/tds/reports/tds-reports/endpoints/fetch_jobs"}]},{"group":"TCS","pages":[{"group":"Create Job","pages":[{"title":"Submit Job","openapi":"api-reference/tds/reports/openapi.json POST /tcs/reports/txt","href":"/api-reference/tds/reports/tcs-reports/endpoints/submit_job"},{"title":"TCS Payments","mode":"wide","href":"/api-reference/tds/reports/tcs-reports/tcs_payments"}]},{"title":"Poll Job","openapi":"api-reference/tds/reports/openapi.json GET /tcs/reports/txt","href":"/api-reference/tds/reports/tcs-reports/endpoints/poll_job"},{"title":"Job status webhook","openapi":"api-reference/tds/reports/openapi.json webhook TCSReportsJobStatus","href":"/api-reference/tds/reports/tcs-reports/endpoints/webhook"},{"title":"Fetch Jobs","openapi":"api-reference/tds/reports/openapi.json POST /tcs/reports/txt/search","href":"/api-reference/tds/reports/tcs-reports/endpoints/fetch_jobs"}]}]},{"group":"Compliance","icon":"box-check","pages":[{"title":"TDS compliance API","sidebarTitle":"Overview","href":"/api-reference/tds/compliance/overview"},{"title":"OpenAPI Spec","url":"https://developer.sandbox.co.in/api-reference/tds/compliance/openapi.json","href":"/api-reference/tds/compliance/openapi-specification"},{"group":"Certificate APIs","pages":[{"title":"TDS and TCS certificate APIs","sidebarTitle":"Overview","href":"/api-reference/tds/compliance/certificates/overview"},{"group":"Enriched APIs","pages":[{"title":"Add TRACES credentials","sidebarTitle":"Add credentials","openapi":"api-reference/tds/compliance/openapi.json POST /tds/traces/deductors/credential","href":"/api-reference/tds/compliance/traces-credentials/endpoints/save_credential"},{"title":"Delete TRACES credentials","sidebarTitle":"Delete credentials","openapi":"api-reference/tds/compliance/openapi.json DELETE /tds/traces/deductors/credential","href":"/api-reference/tds/compliance/traces-credentials/endpoints/delete_credential"},{"title":"Create TDS or TCS certificate job","sidebarTitle":"Create certificate job","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/enriched/traces/deductor/certificates/{certificate_type}","href":"/api-reference/tds/compliance/certificates/endpoints/submit_job"},{"title":"Get TDS or TCS certificate job status","sidebarTitle":"Get certificate job status","openapi":"api-reference/tds/compliance/openapi.json GET /tds/compliance/enriched/traces/deductor/certificates/{certificate_type}/status","href":"/api-reference/tds/compliance/certificates/endpoints/poll_job"},{"title":"Search TDS and TCS certificate jobs","sidebarTitle":"Search certificate jobs","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/enriched/traces/deductor/certificates/{certificate_type}/search","href":"/api-reference/tds/compliance/certificates/endpoints/fetch_job"},{"title":"TDS and TCS certificate webhook","sidebarTitle":"Certificate webhook","openapi":"api-reference/tds/compliance/openapi.json webhook CertificateJobStatus","href":"/api-reference/tds/compliance/certificates/endpoints/webhook"}]},{"group":"APIs","pages":[{"title":"Authenticate a TRACES deductor","sidebarTitle":"Authenticate","openapi":"api-reference/tds/compliance/openapi.json POST /tds/traces/deductors/authenticate","href":"/api-reference/tds/compliance/traces/endpoints/authenticate"},{"title":"Refresh a TRACES deductor session","sidebarTitle":"Refresh","openapi":"api-reference/tds/compliance/openapi.json POST /tds/traces/deductors/refresh","href":"/api-reference/tds/compliance/traces/endpoints/refresh"},{"title":"Create a certificate job with a deductor token","sidebarTitle":"Create certificate job","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/traces/deductor/certificates/{certificate_type}","href":"/api-reference/tds/compliance/certificates/endpoints/submit_with_deductor_token"},{"title":"Get certificate job status with a deductor token","sidebarTitle":"Get certificate job status","openapi":"api-reference/tds/compliance/openapi.json GET /tds/compliance/traces/deductor/certificates/{certificate_type}/status","href":"/api-reference/tds/compliance/certificates/endpoints/poll_with_deductor_token"}]}]},{"group":"TRACES APIs","hidden":true,"pages":[{"title":"TRACES APIs","sidebarTitle":"Overview","href":"/api-reference/tds/compliance/traces/overview"},{"group":"Enriched APIs","pages":[{"group":"PAN verification","pages":[{"title":"Create a bulk PAN verification job","sidebarTitle":"Submit job","openapi":"api-reference/tds/compliance-internal/openapi.json POST /tds/compliance/enriched/traces/deductors/pan/verify","href":"/api-reference/tds/compliance/pan-verification/endpoints/submit_job"},{"title":"Get bulk PAN verification job status","sidebarTitle":"Poll job","openapi":"api-reference/tds/compliance-internal/openapi.json GET /tds/compliance/enriched/traces/deductors/pan/verify/status","href":"/api-reference/tds/compliance/pan-verification/endpoints/poll_job"},{"title":"Bulk PAN verification webhook","sidebarTitle":"Job status webhook","openapi":"api-reference/tds/compliance-internal/openapi.json webhook PanVerificationJobStatus","href":"/api-reference/tds/compliance/pan-verification/endpoints/webhook"},{"title":"Bulk PAN verification input workbook","sidebarTitle":"Payee workbook","mode":"wide","href":"/api-reference/tds/compliance/pan-verification/payee_workbook"},{"title":"Bulk PAN verification output workbook","sidebarTitle":"PAN verification workbook","mode":"wide","href":"/api-reference/tds/compliance/pan-verification/pan_verification_workbook"}]}]},{"group":"APIs","pages":[{"group":"Challans","pages":[{"title":"Fetch TDS challan details","openapi":"api-reference/tds/compliance-internal/openapi.json POST /tds/compliance/traces/deductors/challan","href":"/api-reference/tds/compliance/challans/endpoints/fetch_challan"},{"title":"Search TDS challans","openapi":"api-reference/tds/compliance-internal/openapi.json POST /tds/compliance/traces/deductors/challans/search","href":"/api-reference/tds/compliance/challans/endpoints/search_challans"}]},{"group":"PAN verification","pages":[{"title":"Submit PANs for TRACES verification","sidebarTitle":"Submit PANs","openapi":"api-reference/tds/compliance-internal/openapi.json POST /tds/compliance/traces/deductors/pan/verify","href":"/api-reference/tds/compliance/pan-verification/endpoints/submit_verification"},{"title":"Get TRACES PAN verification status","sidebarTitle":"Get verification status","openapi":"api-reference/tds/compliance-internal/openapi.json GET /tds/compliance/traces/deductors/pan/verify/status","href":"/api-reference/tds/compliance/pan-verification/endpoints/poll_verification"},{"title":"Payee workbook for token-based PAN verification","sidebarTitle":"Payee workbook","mode":"wide","href":"/api-reference/tds/compliance/pan-verification/vanilla_payee_workbook"},{"title":"PAN verification workbook for token-based requests","sidebarTitle":"PAN verification workbook","mode":"wide","href":"/api-reference/tds/compliance/pan-verification/vanilla_pan_verification_workbook"}]}]}]},{"group":"Generate FVU","pages":[{"title":"Create FVU generation job","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/fvu/generate","href":"/api-reference/tds/compliance/generate-fvu/endpoints/submit_job"},{"title":"Get FVU generation job status","openapi":"api-reference/tds/compliance/openapi.json GET /tds/compliance/fvu/generate","href":"/api-reference/tds/compliance/generate-fvu/endpoints/poll_job"},{"title":"FVU generation status webhook","openapi":"api-reference/tds/compliance/openapi.json webhook FVUGenerateJobStatus","href":"/api-reference/tds/compliance/generate-fvu/endpoints/webhook"},{"title":"Search FVU generation jobs","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/fvu/generate/search","href":"/api-reference/tds/compliance/generate-fvu/endpoints/search_job"}]},{"group":"E-File","pages":[{"title":"Create TDS return e-filing job","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/e-file","href":"/api-reference/tds/compliance/e-file/endpoints/submit_job"},{"title":"Get TDS return e-filing status","openapi":"api-reference/tds/compliance/openapi.json GET /tds/compliance/e-file","href":"/api-reference/tds/compliance/e-file/endpoints/poll_job"},{"title":"TDS return e-filing status webhook","openapi":"api-reference/tds/compliance/openapi.json webhook EFileJobStatus","href":"/api-reference/tds/compliance/e-file/endpoints/webhook"},{"title":"Search TDS return e-filing jobs","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/e-file/search","href":"/api-reference/tds/compliance/e-file/endpoints/search_job"}]},{"group":"Download CSI","pages":[{"title":"Generate OTP for CSI download","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/csi/otp","href":"/api-reference/tds/compliance/download-csi/endpoints/generate_otp"},{"title":"Verify OTP for CSI download","openapi":"api-reference/tds/compliance/openapi.json POST /tds/compliance/csi/otp/verify","href":"/api-reference/tds/compliance/download-csi/endpoints/verify_otp"}]}]},{"group":"Annexures","pages":[{"title":"TDS annexures","href":"/api-reference/tds/annexures/tds_annexures"},{"title":"Master data","href":"/api-reference/tds/annexures/master_data"}]}]},{"item":"Income Tax","icon":"https://mintlify.s3.us-west-1.amazonaws.com/in-co-sandbox/static/svg/workload-icons/IT.svg","description":"Direct tax compliance on auto-pilot","pages":[{"title":"Income Tax","href":"/api-reference/it/overview"}]},{"item":"Bank","icon":"https://mintlify.s3.us-west-1.amazonaws.com/in-co-sandbox/static/svg/Bank.svg","description":"Bank APIs","hidden":true,"pages":[{"title":"Bank","href":"/api-reference/bank/overview"}]}]},{"tab":"Recipes","icon":"flask","menu":[{"item":"KYC","description":"Quick recipes for fast, reliable identity checks.","pages":[{"title":"KYC","href":"/recipes/kyc/introduction"}]},{"item":"GST","description":"Easy steps for smooth, error-free GST workflows.","pages":[{"title":"GST","href":"/recipes/gst/introduction"}]},{"item":"TDS","description":"Guides to set up seamless, automated TDS.","pages":[{"title":"TDS","href":"/recipes/tds/introduction"}]},{"item":"Income Tax","description":"Ready flows to automate your Income tax tasks.","pages":[{"title":"Income Tax","href":"/recipes/it/introduction"}]}],"pages":[{"title":"Recipes","href":"/recipes/kyc/introduction"}]},{"tab":"Changelog","icon":"clock","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Resources","icon":"books","menu":[{"item":"Postman Collections","icon":"book-bookmark","href":"https://www.postman.com/in-co-sandbox/sandbox-api"},{"item":"SDKs \u0026 Clients","icon":"cube","href":"https://github.com/in-co-sandbox"},{"item":"MCP Server","icon":"server","description":"","href":"https://developer.sandbox.co.in/mcp"},{"item":"Status","icon":"signal-stream","href":"https://status.api.sandbox.co.in/"},{"item":"Pricing","icon":"indian-rupee-sign","href":"https://sandbox.co.in/pricing?utm_campaign=header-menu\u0026utm_source=in-co-sandbox-developer\u0026utm_medium=direct"},{"item":"Customer Stories","icon":"users","href":"https://sandbox.co.in/customers"}]}]},"basePath":"","title":"Calculate TCS - Sandbox","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B6WFFOBL.js","utils-BN5um1KA.js","cloneDeep-C3md22mN.js","_Uint8Array-DLlL8L26.js","isObject-FP1Yky1u.js","utils-BSmbkXJR.js","addUniqueKeysToSchema-2tqcVnUE.js","snippetPresets-CtWfvr2J.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DkKHBy30.js","isEqual-O3q7y6pq.js","usePlaygroundInputsStore-Brc5H9UJ.js","shallow-C4L4xvbs.js","getApiPlaygroundDisplay-2bxyq_aI.js","CodeSnippet-BJu8ddd5.js","CodeSnippets-dazWmoqB.js","Page-CnLhKuUV.js","getPastedJson-Chy3Qa1S.js","icon-CyO7h3jh.js","MethodPill-Dle0_91v.js","DuplicateIcon-CVvWAf4a.js","createIcon-Di07A27B.js","DynamicMarkdown-C4w9kavL.js","SectionHeading-XiBebVYC.js","axios-vUo_bRtp.js","Markdown-DTeL0SpS.js","dist-OCScizqf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-KcneGfMY.js"]}