Taxation & Salary APIWeb Calculator UI
Free Gratuity Calculator API (2026)
API calculating gratuity as 15 days of last wages per year of service (monthly wages ÷ 26 × 15), with a part year over six months counted as a full year, the ₹20 lakh statutory ceiling, and the tax split on the amount actually paid.
Interactive API Playground & Live Test
GET
/api/v1/gratuityQuery Parameters
Last drawn monthly basic + DA + retaining allowance in ₹ (not_covered: average of the last 10 months)
Completed years of continuous service
Extra whole months; more than 6 counts as a full year (default: 0)
covered | fixed_term | not_covered | government (default: covered)
Monthly HRA, conveyance, bonus, employer PF, overtime and commission; the part above half of total pay is added to wages (covered and fixed_term only)
Gratuity the employer actually pays, if different; the tax split uses it
curl -X GET "https://fincalculator.in/api/v1/gratuity?basic=80000&years=10&months=0&employmentType=covered&otherPay=0&amountPaid=0" \
-H "Accept: application/json"Live JSON Response (HTTP 200 OK)
Click "Execute Live API Request" below...Request Parameters Schema
| Parameter | Type | Required | Description / Notes |
|---|---|---|---|
| basic | number | Required | Last drawn monthly basic + DA + retaining allowance in ₹ (not_covered: average of the last 10 months) |
| years | number | Required | Completed years of continuous service |
| months | number | Optional | Extra whole months; more than 6 counts as a full year (default: 0) |
| employmentType | string | Optional | covered | fixed_term | not_covered | government (default: covered) |
| otherPay | number | Optional | Monthly HRA, conveyance, bonus, employer PF, overtime and commission; the part above half of total pay is added to wages (covered and fixed_term only) |
| amountPaid | number | Optional | Gratuity the employer actually pays, if different; the tax split uses it |
Related Taxation & Salary APIs
Frequently Asked Questions (FAQs)
Is the Free Gratuity 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/gratuity?
Endpoints are cached at the edge for 24 hours. There are no restrictive rate limits for standard web traffic and mobile applications.