Türkiye Working Days Calculator: API and MCP

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

Id: time.working-days.tr
Version: 1.0.0
Access: Free
Tool page: Türkiye Working Days Calculator
Schema: GET /api/v1/tools/time.working-days.tr

Input

Field	Type	Constraints	Default	Description
`mode`	string	between \| add	between	What to calculate
`start` (required)	string			Start date · Between two dates this day counts. When adding working days, the count starts the next day.
`end`	string			End date · This day counts too.
`days`	integer	≥ 1, ≤ 1,000		Working days to add (working days)
`saturday`	string	no \| yes	no	Is Saturday a working day?
`halfDays`	string	half \| working \| off	half	Half days (holiday eves, 28 October)
`administrativeLeave`	string	no \| yes	no	Administrative leave days · Days a circular gives public servants off. They are not public holidays.

Output

Field	Type	Description
`endDate`	string	Date of the last working day
`workingDays`	number	Working days (days)
`calendarDays`	number	Calendar days (days)
`restDays`	number	Weekend days (days)
`holidayDays`	number	Public holidays on working days (days)
`halfHolidays`	number	Half-day holidays on working days (days)
`leaveDays`	number	Administrative leave on working days (days)
`days`	array	Working days taken off

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/time.working-days.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"mode":"between","start":"2026-01-01","end":"2026-12-31","saturday":"no","halfDays":"half","administrativeLeave":"no"},"locale":"en"}'

Example answer

{
  "output": {
    "workingDays": 249.5,
    "calendarDays": 365,
    "restDays": 104,
    "holidayDays": 11.5,
    "halfHolidays": 3,
    "days": [
      {
        "day": "2026-01-01",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-03-19",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-03-20",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-04-23",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-01",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-19",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-26",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-05-27",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-28",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-05-29",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-07-15",
        "holiday": 1,
        "leave": 0
      },
      {
        "day": "2026-10-28",
        "holiday": 0.5,
        "leave": 0
      },
      {
        "day": "2026-10-29",
        "holiday": 1,
        "leave": 0
      }
    ]
  },
  "steps": [
    {
      "id": "calendarDays",
      "formula": "calendar days = end − start + 1",
      "substitution": "calendar days = 2026-12-31 − 2026-01-01 + 1",
      "value": 365,
      "unit": "days"
    },
    {
      "id": "restDays",
      "formula": "weekend days = Saturdays + Sundays",
      "substitution": "weekend days = 52 + 52",
      "value": 104,
      "unit": "days"
    },
    {
      "id": "holidayDays",
      "formula": "public holidays = full days + half days × 0.5",
      "substitution": "public holidays = 10 + 3 × 0.5",
      "value": 11.5,
      "unit": "days"
    },
    {
      "id": "workingDays",
      "formula": "working days = calendar days − weekend days − public holidays",
      "substitution": "working days = 365 − 104 − 11.5",
      "value": 249.5,
      "unit": "days"
    }
  ],
  "notes": [
    {
      "kind": "difference",
      "code": "administrative_leave_in_range",
      "values": {
        "days": 1.5
      },
      "text": "Public servants had 1.5 days of administrative leave in this range; the result counts them as working days. If you are a public servant, turn on the administrative leave option."
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/time/turkey-working-days-calculator",
    "title": "Türkiye Working Days Calculator"
  }
}