Taxation & Salary APIWeb Calculator UI
Free CTC to In-Hand Take-Home Salary Calculator API (2026)
API for converting Cost to Company (CTC) package into itemized gross salary, employee PF, PT, and net bank payout.
Interactive API Playground & Live Test
GET
/api/v1/ctcQuery Parameters
Annual CTC in ₹
new | old (default: new)
Variable pay inside the CTC, paid once a year. Left out of netInHandMonthly; averageInHandMonthly includes it.
Employer group health premium inside the CTC (default ₹10,000)
Basic pay as % of CTC, 10 to 90 (default: 50)
Employer NPS as % of basic (default: 0). Up to 14% is deducted under 80CCD(2) (10% under the old regime for a private employer); any more is taxed as salary
Set "true" for a Central or State Government employer: under the old regime its NPS is deductible up to 14% of basic, not 10% (default: false)
curl -X GET "https://fincalculator.in/api/v1/ctc?ctc=1200000®ime=new&variableBonusAnnual=0&insuranceAnnual=10000&basicPercent=50&employerNpsPercent=0&governmentEmployer=false" \
-H "Accept: application/json"Live JSON Response (HTTP 200 OK)
Click "Execute Live API Request" below...Request Parameters Schema
| Parameter | Type | Required | Description / Notes |
|---|---|---|---|
| ctc | number | Required | Annual CTC in ₹ |
| regime | string | Optional | new | old (default: new) |
| variableBonusAnnual | number | Optional | Variable pay inside the CTC, paid once a year. Left out of netInHandMonthly; averageInHandMonthly includes it. |
| insuranceAnnual | number | Optional | Employer group health premium inside the CTC (default ₹10,000) |
| basicPercent | number | Optional | Basic pay as % of CTC, 10 to 90 (default: 50) |
| employerNpsPercent | number | Optional | Employer NPS as % of basic (default: 0). Up to 14% is deducted under 80CCD(2) (10% under the old regime for a private employer); any more is taxed as salary |
| governmentEmployer | boolean | Optional | Set "true" for a Central or State Government employer: under the old regime its NPS is deductible up to 14% of basic, not 10% (default: false) |
Related Taxation & Salary APIs
Frequently Asked Questions (FAQs)
Is the Free CTC to In-Hand Take-Home Salary Calculator API free to use in production apps?
Yes! All FinCalculator REST APIs are completely free, zero-auth, open-CORS, and edge-cached for high performance across global web and mobile applications.
What is the rate limit for /api/v1/ctc?
Endpoints are cached at the edge for 24 hours. There are no restrictive rate limits for standard web traffic and mobile applications.