Türkiye Maternity & Paternity Leave Calculator: API and MCP

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

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

Input

Field	Type	Constraints	Default	Description
`status`	string	worker \| civil-servant \| contract \| self-employed	worker	Status · The status of the person who takes the leave. An employee of a public body under an employment contract is an “Employee”.
`leave`	string	maternity \| paternity \| adoption \| mother-died	maternity	Leave
`expectedDate`	string			Expected birth date · The due date the doctor gave (week 40).
`birthDate`	string			Birth date · For maternity leave, enter it after the birth; when empty, the expected date is used. Required for paternity leave. For adoption, the child’s birth date.
`pregnancy`	string	single \| multiple	single	Pregnancy
`workedWeeks`	integer	≥ 0, ≤ 8	0	Weeks worked before the birth (weeks) · With a doctor’s approval one can work until 2 weeks before the birth: at most 6 weeks with one baby, 8 with a multiple pregnancy. These weeks move to after the birth.
`deathDate`	string			Date of the mother’s death
`handoverDate`	string			Handover date · The day the child was handed over to the family. It can be before the adoption decision.
`paternityStart`	string			First day of paternity leave · Leave it empty to use the birth date.
`birthOrder`	string	first \| second \| later	first	Birth (or child) order · It sets the half-time work period.
`disabledChild`	string	no \| yes	no	Child born disabled

Output

Field	Type	Description
`leaveStart`	string	First day of leave
`leaveEnd`	string	Last day of leave
`returnDate`	string	Day back at work
`totalDays`	number	Total leave (days)
`totalWeeks`	number	Total leave (full weeks) (weeks)
`totalExtraDays`	number	Days after the full weeks (days)
`beforeEnd`	string	Last day of leave before the birth
`beforeDays`	number	Leave used before the birth (days)
`afterStart`	string	First day of leave after the birth
`afterDays`	number	Leave after the birth (days)
`movedDays`	number	Moved to after the birth (days)
`nursingHours`	number	Nursing leave (from the return) (hours a day)
`nursingLaterFrom`	string	Day the nursing hours drop
`nursingLaterHours`	number	Nursing leave (from that day) (hours a day)
`nursingEnd`	string	Last day of nursing leave
`halfTimeStart`	string	First day of half-time work (optional)
`halfTimeEnd`	string	Last day of half-time work
`halfTimeDays`	number	Half-time work (days)

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/labor.maternity-leave.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"status":"worker","leave":"maternity","expectedDate":"2026-12-01","pregnancy":"single","workedWeeks":0,"birthOrder":"first","disabledChild":"no"},"locale":"en"}'

Example answer

{
  "output": {
    "leaveStart": "2026-10-06",
    "leaveEnd": "2027-03-22",
    "returnDate": "2027-03-23",
    "totalDays": 168,
    "totalWeeks": 24,
    "beforeEnd": "2026-11-30",
    "beforeDays": 56,
    "afterStart": "2026-12-01",
    "afterDays": 112,
    "movedDays": 0,
    "nursingHours": 1.5,
    "nursingEnd": "2027-11-30",
    "halfTimeStart": "2027-03-23",
    "halfTimeEnd": "2027-05-21",
    "halfTimeDays": 60
  },
  "steps": [
    {
      "id": "before",
      "formula": "leave before the birth = (weeks before the birth − weeks worked) × 7",
      "substitution": "2026-10-06 – 2026-11-30: (8 − 0) × 7",
      "value": 56,
      "unit": "days"
    },
    {
      "id": "used",
      "formula": "leave used before the birth = birth date − first day of leave",
      "substitution": "2026-12-01 − 2026-10-06",
      "value": 56,
      "unit": "days"
    },
    {
      "id": "moved",
      "formula": "moved to after the birth = weeks worked × 7 + unused days",
      "substitution": "0 × 7 + (56 − 56)",
      "value": 0,
      "unit": "days"
    },
    {
      "id": "after",
      "formula": "leave after the birth = 16 × 7 + moved to after the birth",
      "substitution": "2026-12-01 – 2027-03-22: 16 × 7 + 0",
      "value": 112,
      "unit": "days"
    },
    {
      "id": "total",
      "formula": "total leave = leave used before the birth + leave after the birth",
      "substitution": "56 + 112",
      "value": 168,
      "unit": "days"
    },
    {
      "id": "nursing",
      "formula": "nursing leave = the child’s first birthday − day back at work",
      "substitution": "2027-03-23 – 2027-11-30: 12 months × 1.5 hours",
      "value": 253,
      "unit": "days"
    },
    {
      "id": "halfTime",
      "formula": "half-time work = first birth",
      "substitution": "2027-03-23 – 2027-05-21: 60 days",
      "value": 60,
      "unit": "days"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-05-08",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/salary-and-work/turkey-maternity-leave-calculator",
    "title": "Türkiye Maternity & Paternity Leave Calculator"
  }
}