Türkiye Annual Leave Calculator: API and MCP

Türkiye Annual Leave Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: labor.annual-leave.tr
Version: 1.0.0
Access: Free
Tool page: Türkiye Annual Leave Calculator
Schema: GET /api/v1/tools/labor.annual-leave.tr

Input

Field	Type	Constraints	Default	Description
`startDate` (required)	string			Start date · The day you started with this employer, probation included.
`on`	string			Day to check · Leave it empty to use today (Türkiye time). If you are leaving, enter your last working day.
`birthDate`	string			Date of birth · Optional. Workers aged 18 or under, or 50 or over, get at least 20 days.
`underground`	string	no \| yes	no	Underground work
`unusedDays`	integer	≥ 0, ≤ 1,000		Unused leave days (days) · Optional, for the leave pay when the job ends.
`grossWage`	number	> 0, ≤ 100,000,000		Last monthly gross wage (TRY) · Optional, for the leave pay.

Output

Field	Type	Description
`leaveDays`	number	Leave of this leave year (days)
`years`	number	Full years
`months`	number	Months
`days`	number	Days
`nextLeaveDays`	number	Leave of the next leave year (days)
`daysToNextYear`	number	Days to the next full year (days)
`age`	number	Age at the start of the leave year (years)
`dailyWage`	number	Daily gross wage (TRY)
`leavePay`	number	Gross leave pay (TRY)

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/labor.annual-leave.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"startDate":"2019-03-01","on":"2026-09-28","birthDate":"1990-05-15","underground":"no","unusedDays":12,"grossWage":50000},"locale":"en"}'

Example answer

{
  "output": {
    "leaveDays": 20,
    "years": 7,
    "months": 6,
    "days": 28,
    "nextLeaveDays": 20,
    "daysToNextYear": 153,
    "age": 35,
    "dailyWage": 1666.67,
    "leavePay": 20000
  },
  "steps": [
    {
      "id": "years",
      "formula": "service = day checked − start date (both days counted)",
      "substitution": "service = 2026-09-28 − 2019-03-01 = 7 years 6 months 28 days",
      "value": 7,
      "unit": "years"
    },
    {
      "id": "leaveDays",
      "formula": "annual leave = 14, 20 or 26 days by service; at least 20 days at age 18 or under, 50 or over; + 4 days in underground work",
      "substitution": "annual leave = 20 (service 7 years → 20; age 35)",
      "value": 20,
      "unit": "days"
    },
    {
      "id": "nextLeaveDays",
      "formula": "leave of the next leave year = 14, 20 or 26 days by service; at least 20 days at age 18 or under, 50 or over; + 4 days in underground work",
      "substitution": "leave of the next leave year = 20 (service 8 years → 20; age 36)",
      "value": 20,
      "unit": "days"
    },
    {
      "id": "daysToNextYear",
      "formula": "days to the next full year = last day of service year 8 − day checked",
      "substitution": "days to the next full year = 2027-02-28 − 2026-09-28",
      "value": 153,
      "unit": "days"
    },
    {
      "id": "dailyWage",
      "formula": "daily gross wage = monthly gross wage / 30",
      "substitution": "daily gross wage = 50,000.00 / 30",
      "value": 1666.67,
      "unit": "TRY"
    },
    {
      "id": "leavePay",
      "formula": "leave pay = monthly gross wage / 30 × unused days",
      "substitution": "leave pay = 50,000.00 / 30 × 12",
      "value": 20000,
      "unit": "TRY"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/salary-and-work/turkey-annual-leave-calculator",
    "title": "Türkiye Annual Leave Calculator"
  }
}