curatedapi

Working days calculator with public holidays

Working days between two dates, or the date a number of working days away, leaving out weekends and a country's public holidays.

The start date.
The end date, to count working days.
Working days to move from start, to find a date; negative to go back. The start date itself is not counted.
The public holidays to leave out (2020 to 2030). Omit it to count only weekends and extra_holidays. Options: US: United States (federal holidays); GB-ENG: United Kingdom: England and Wales; GB-SCT: United Kingdom: Scotland; GB-NIR: United Kingdom: Northern Ireland; DE: Germany (the nine nationwide holidays); DE-BW: Germany: Baden-Württemberg; DE-BY: Germany: Bavaria; DE-BE: Germany: Berlin; DE-BB: Germany: Brandenburg; DE-HB: Germany: Bremen; DE-HH: Germany: Hamburg; DE-HE: Germany: Hesse; DE-MV: Germany: Mecklenburg-Vorpommern; DE-NI: Germany: Lower Saxony; DE-NW: Germany: North Rhine-Westphalia; DE-RP: Germany: Rhineland-Palatinate; DE-SL: Germany: Saarland; DE-SN: Germany: Saxony; DE-ST: Germany: Saxony-Anhalt; DE-SH: Germany: Schleswig-Holstein; DE-TH: Germany: Thuringia; FR: France (mainland); NL: Netherlands; IE: Ireland; BE: Belgium; AT: Austria; IT: Italy
Days of the week that are not worked. Options: sat_sun: Saturday and Sunday; fri_sat: Friday and Saturday; sun: Sunday only; fri: Friday only; none: no weekend days
More days that are not worked, such as company closing days. Up to 1000 items. One per line, or separated by commas.
When counting: whether the end date counts too. Without it the count runs from start up to the day before end.

Examples

Example: Five working days after 21 December 2026 in England

Result
The date add_days working days away.
2026-12-30
Weekday
The result's day of the week.
Wednesday

Holidays skipped

DateWeekdayName
2026-12-25FridayChristmas Day
2026-12-28MondayBoxing Day (substitute day)

Calculator date/working-days@1.

How it is calculated

days in the span that are not a weekend day, a public holiday of the calendar or an extra holiday

Counts the working days between two dates, or finds the date that lies a number of working days after (or before) a start date. Weekends and the public holidays of the chosen country or region are left out, and you can add your own closing days. The answer lists the holidays it skipped, so the count can be checked by hand.

  • Holiday calendars cover 2020 to 2030. They follow the rules in each country's law, plus the one-off days that were proclaimed for a single year. A government can still add or move a day for a year ahead; such a change is added here when it becomes law.
  • Holidays that apply only in some towns or districts are not included (for example Assumption Day in most of Bavaria, Corpus Christi in parts of Saxony and Thuringia, and Good Friday in Alsace-Moselle).

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Use it from your code

POST /v1/calc/date/working-daysVersion 1
curl https://api.curatedapi.com/v1/calc/date/working-days \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "start": "2026-12-21",
    "add_days": 5,
    "calendar": "GB-ENG"
  }'
The same call in Python
import os

import requests

payload = {
    "start": "2026-12-21",
    "add_days": 5,
    "calendar": "GB-ENG",
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/date/working-days",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "start": "2026-12-21",
    "add_days": 5,
    "calendar": "GB-ENG",
};
const response = await fetch("https://api.curatedapi.com/v1/calc/date/working-days", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
console.log((await response.json()).result);

MCP tool calc_date_working_days at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="date/working-days" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>

Use a public key registered for your site. Calculations are billed like API calls. How widgets work.

Related calculators

Add this calculator to your website

Paste two lines into your page and your visitors get this calculator. Each use counts as one call on your plan, the same as the API.

Free for up to 1,000 uses a month. 50,000 uses a month cost $9.00 on the Starter plan.