Türkiye Unemployment Benefit Calculator: API and MCP

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

Id: labor.unemployment-benefit.tr
Version: 1.0.0
Access: Free
Tool page: Türkiye Unemployment Benefit Calculator
Schema: GET /api/v1/tools/labor.unemployment-benefit.tr

Input

Field	Type	Constraints	Default	Description
`earningsBasis`	string	average \| months	average	Earnings as
`gross`	number	> 0, ≤ 10,000,000		Monthly gross earnings (TRY) · The monthly average of the gross earnings on which premiums were paid in the last 4 full months (on your SGK service statement). If every month was the same, enter your gross salary.
`gross1`	number	> 0, ≤ 10,000,000		Month 1 (TRY) · Gross earnings on which premiums were paid in the last 4 full months; the order does not matter.
`gross2`	number	> 0, ≤ 10,000,000		Month 2 (TRY)
`gross3`	number	> 0, ≤ 10,000,000		Month 3 (TRY)
`gross4`	number	> 0, ≤ 10,000,000		Month 4 (TRY)
`premiumDays` (required)	integer	≥ 0, ≤ 1,080		Premium days in the last 3 years (days) · Days with unemployment insurance premium in the 3 years before the job ended. At least 600 are needed.
`endDate`	string			Job end date · Your last day of work. Leave it empty to use today (Türkiye time).

Output

Field	Type	Description
`monthlyNet`	number	Monthly net unemployment benefit (TRY)
`monthlyGross`	number	Monthly gross benefit (TRY)
`dailyGross`	number	Daily gross benefit (TRY)
`stampDuty`	number	Stamp duty (TRY)
`cap`	number	Monthly cap (TRY)
`averageEarnings`	number	Average monthly gross earnings (TRY)
`days`	number	Benefit period (days)
`totalGross`	number	Total gross benefit (TRY)
`totalNet`	number	Total net benefit (TRY)

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/labor.unemployment-benefit.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"earningsBasis":"average","gross":33030,"premiumDays":700,"endDate":"2026-09-15"},"locale":"en"}'

Example answer

{
  "output": {
    "monthlyNet": 13111.72,
    "monthlyGross": 13212,
    "dailyGross": 440.4,
    "stampDuty": 100.28,
    "cap": 26424,
    "averageEarnings": 33030,
    "days": 180,
    "totalGross": 79272,
    "totalNet": 78670.32
  },
  "steps": [
    {
      "id": "averageEarnings",
      "formula": "average monthly gross earnings = the amount given",
      "substitution": "average monthly gross earnings = 33,030.00",
      "value": 33030,
      "unit": "TRY"
    },
    {
      "id": "calculated",
      "formula": "calculated benefit = average monthly gross earnings × 40%",
      "substitution": "calculated benefit = 33,030.00 × 40%",
      "value": 13212,
      "unit": "TRY"
    },
    {
      "id": "cap",
      "formula": "cap = gross minimum wage × 80%",
      "substitution": "cap = 33,030.00 × 80%",
      "value": 26424,
      "unit": "TRY"
    },
    {
      "id": "monthlyGross",
      "formula": "monthly gross benefit = min(calculated benefit, cap)",
      "substitution": "monthly gross benefit = min(13,212.00, 26,424.00)",
      "value": 13212,
      "unit": "TRY"
    },
    {
      "id": "dailyGross",
      "formula": "daily benefit = monthly gross benefit / 30",
      "substitution": "daily benefit = 13,212.00 / 30",
      "value": 440.4,
      "unit": "TRY"
    },
    {
      "id": "stampDuty",
      "formula": "stamp duty = monthly gross benefit × 7.59‰",
      "substitution": "stamp duty = 13,212.00 × 7.59‰",
      "value": 100.28,
      "unit": "TRY"
    },
    {
      "id": "monthlyNet",
      "formula": "monthly net benefit = monthly gross benefit − stamp duty",
      "substitution": "monthly net benefit = 13,212.00 − 100.28",
      "value": 13111.72,
      "unit": "TRY"
    },
    {
      "id": "days",
      "formula": "benefit period = 180 days (600+ premium days)",
      "substitution": "benefit period = 700 premium days → 180 days",
      "value": 180,
      "unit": "days"
    },
    {
      "id": "totalNet",
      "formula": "total net benefit = monthly net benefit × 6",
      "substitution": "total net benefit = 13,111.72 × 6 (2026-09-16 – 2027-03-14)",
      "value": 78670.32,
      "unit": "TRY"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/salary-and-work/turkey-unemployment-benefit-calculator",
    "title": "Türkiye Unemployment Benefit Calculator"
  }
}