Gratuity Calculator API
Calculate gratuity payable under the Payment of Gratuity Act, 1972 — with eligibility check and ₹20 lakh tax-exemption breakdown.
Fast & Accurate
Get precise results instantly.
Easy Integration
Simple REST API with JSON response.
Developer Friendly
Clear docs and SDK examples.
Free to Start
1,000 free requests/month.
Endpoint
All requests should be made to the following endpoint:
POST https://api.tools.town/v1/calculators/gratuity Authentication
This endpoint requires an API Key. Include your API key in the request header.
Request Parameters
Send a POST request with JSON body.
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
lastDrawnSalary | number | ✓ | Last drawn monthly salary (basic + DA). | 50000 |
yearsOfService | number | ✓ | Completed years of service. | 8 |
monthsOfService | number | ✕ | Additional months (0–11). | 6 |
coveredUnderAct | boolean | ✕ | Covered under Payment of Gratuity Act. | true |
Example Request
curl -X POST "https://api.tools.town/v1/calculators/gratuity" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"lastDrawnSalary": 50000,
"yearsOfService": 8
}' Example Response 200 OK
{
"success": true,
"data": {
"lastDrawnSalary": "0",
"yearsOfService": "0",
"monthsOfService": "0",
"effectiveYears": "0",
"coveredUnderAct": "true",
"eligible": "true",
"gratuityAmount": "0",
"taxExemptAmount": "0",
"taxableAmount": "0"
}
} Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — missing or invalid parameter |
| 401 | Unauthorized — API key missing or invalid |
| 429 | Rate limit exceeded — free tier: 1,000 requests/month |
| 500 | Internal Server Error — try again or contact support |