Skip to content
Tools.Town
290+ free online tools

Gratuity Calculator API

Calculate gratuity payable under the Payment of Gratuity Act, 1972 — with eligibility check and ₹20 lakh tax-exemption breakdown.

Category: Finance Endpoint: /v1/calculators/gratuity Method: POST Auth: API Key

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:

POSThttps://api.tools.town/v1/calculators/gratuity

Authentication

This endpoint requires an API Key. Include your API key in the request header.

Authorization: Bearer YOUR_API_KEY
You can get your API key from your dashboard.

Request Parameters

Send a POST request with JSON body.

ParameterTypeRequiredDescriptionExample
lastDrawnSalarynumberLast drawn monthly salary (basic + DA).50000
yearsOfServicenumberCompleted years of service.8
monthsOfServicenumberAdditional months (0–11).6
coveredUnderActbooleanCovered 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

application/json
{
  "success": true,
  "data": {
    "lastDrawnSalary": "0",
    "yearsOfService": "0",
    "monthsOfService": "0",
    "effectiveYears": "0",
    "coveredUnderAct": "true",
    "eligible": "true",
    "gratuityAmount": "0",
    "taxExemptAmount": "0",
    "taxableAmount": "0"
  }
}

Error Codes

CodeMeaning
400Bad Request — missing or invalid parameter
401Unauthorized — API key missing or invalid
429Rate limit exceeded — free tier: 1,000 requests/month
500Internal Server Error — try again or contact support