---
title: "Holiday Entitlement Calculator"
method: GET
path: "/api/calc/holiday-entitlement-calculator"
tags: ["Everyday"]
---

# Holiday Entitlement Calculator

`GET /api/calc/holiday-entitlement-calculator`

## Request

- Base URL: `https://calcbright.com`
- URL: `https://calcbright.com/api/calc/holiday-entitlement-calculator`
- Auth: none declared

UK holiday entitlement calculator: statutory 5.6 weeks (max 28 days), pro-rata for part-time days or hours, starters and leavers, and 12.07% irregular hours.

## Query parameters

- `basis` 'days' | 'hours' | 'irregular': How do you work?
- `days` number: Days worked per week (days)
- `hours` number: Hours worked per week (hours)
- `worked` number: Hours worked in the pay period (hours) Holiday accrues at 12.07% of hours actually worked (leave years from 1 April 2024).
- `period` 'full' | 'part': Employed for
- `yearStart` string, date: Leave year starts Often 1 January or 1 April – check your contract. (YYYY-MM-DD)
- `start` string, date: Start date Leave blank if before the leave year. (YYYY-MM-DD)
- `end` string, date: Leaving date Leave blank if staying. (YYYY-MM-DD)

## Response `200`

Calculation result

- CalcOutput
  - `ok` boolean
  - `tool` string
  - `name` string
  - `url` string: Open this link to see the full calculation
  - `inputs` object
  - `summary` string: Plain-text answer
  - `details` string
  - `result` object
  - `errors` object

## Other responses

- `400`: Invalid input (see errors)

---

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