---
title: "Computes Turkish severance (kıdem), notice (ihbar) and annual-leave entitlement from service dates and the gross wage, using the official ceiling and minimum-wage tables for the given day."
method: POST
path: "/v1/tr/labor"
tags: ["Turkey"]
---

# Computes Turkish severance (kıdem), notice (ihbar) and annual-leave entitlement from service dates and the gross wage, using the official ceiling and minimum-wage tables for the given day.

`POST /v1/tr/labor`

## Request

- Base URL: `https://api.temsor.com`
- URL: `https://api.temsor.com/v1/tr/labor`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Payroll and HR tools in Turkey chase a parameter that changes every January and July: the severance ceiling, the SGK cap, the minimum wage. This endpoint applies the statutory formulae (Labour Law 4857 arts. 17 and 53, former 1475 art. 14) to those tables. The ceiling is applied to the monthly wage, not the total. Stamp tax (0.759%) is deducted from severance; income tax is not — kıdem is exempt. Notice pay IS taxable; we return the gross and say so, because the actual withholding depends on the employee's cumulative tax base. What this will not tell you: whether the employee is entitled to severance at all. That depends on the reason for termination (retirement, just cause, marriage, military service…). Treating the number as "what is owed" is how you lose at trial.

**Credits per call:** 1 · **Operation id:** `tr_labor`

## Request body

- object
  - `startDate` string, required: Employment start date (YYYY-MM-DD).
  - `endDate` string, required: Termination date (YYYY-MM-DD). Inclusive of this day.
  - `monthlyGross` number, required: Gross monthly wage the severance is based on (giydirilmiş brüt).
  - `asOf` string: Rate table date. Defaults to endDate.
  - `age` integer: Employee age at termination — affects annual-leave entitlement (under 18 or 50+).
  - `unusedLeaveDays` number: Unused annual-leave days, if you also want the unused-leave gross.

## Response `200`

Success

- object
  - `ok` unknown, required
  - `data` object, required
    - `service` object, required
      - `startDate` string, required
      - `endDate` string, required
      - `daysInclusive` number, required
      - `completeYears` number, required
      - `remainderDays` number, required
      - `yearsDecimal` number, required
    - `rates` object, required
      - `asOf` string, required
      - `stampTaxRate` number, required
      - `minWageGross` number, nullable, required
      - `minWageNet` number, nullable, required
      - `severanceCeiling` number, nullable, required
      - `sgkCeilingMonthly` number, nullable, required
      - `sources` string[], required
    - `severance` object, required
      - `monthlyBase` number, required
      - `capped` boolean, required
      - `gross` number, required
      - `stampTax` number, required
      - `net` number, required
      - `formula` string, required
    - `notice` object, required
      - `weeks` number, required
      - `days` number, required
      - `gross` number, required
      - `stampTax` number, required
      - `article` string, required
    - `annualLeave` object, required
      - `entitledDays` number, required
      - `unusedDays` number, nullable, required
      - `unusedGross` number, nullable, required
      - `article` string, required
    - `minWage` object, nullable, required
      - `dailyGross` number, required
      - `monthlyGross` number, required
      - `monthlyNet` number, required
      - `employeeDeductions` number, required
      - `employerCostFull` number, required
      - `employerCostWith5510Discount` number, required
      - `monthlySupport` number, nullable, required
    - `warnings` string[], required
  - `meta` object
    - `credits` integer
    - `cached` boolean
    - `requestId` string
    - `durationMs` integer

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `429`: Rate limit exceeded — wait `Retry-After` seconds. The RateLimit headers are sent here too.

---

[API](https://skmtc.dev/temsor/apis/temsor-api.md) · [All operations](https://skmtc.dev/temsor/apis/temsor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/temsor/apis/temsor-api/revisions/19702107e15a?raw)