Working days with public holidays API
Working days between two dates, or the date a number of working days away, leaving out weekends and a country's public holidays.
POST https://api.curatedapi.com/v1/calc/date/working-days
- Version 1
- MCP tool
calc_date_working_days - Try it in the browser
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.
Formula
days in the span that are not a weekend day, a public holiday of the calendar or an extra holiday
- 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).
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
start required |
date (YYYY-MM-DD) | The start date. |
end |
date (YYYY-MM-DD) | The end date, to count working days. |
add_days |
integer | Working days to move from start, to find a date; negative to go back. The start date itself is not counted. Allowed: >= -2500 and <= 2500. |
calendar |
US | GB-ENG | GB-SCT | GB-NIR | DE | DE-BW | DE-BY | DE-BE | DE-BB | DE-HB | DE-HH | DE-HE | DE-MV | DE-NI | DE-NW | DE-RP | DE-SL | DE-SN | DE-ST | DE-SH | DE-TH | FR | NL | IE | BE | AT | IT | 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 |
weekend |
sat_sun | fri_sat | sun | fri | none default sat_sun |
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 |
extra_holidays |
list of date (YYYY-MM-DD) | More days that are not worked, such as company closing days. Up to 1000 items. |
include_end_date |
boolean default False |
When counting: whether the end date counts too. Without it the count runs from start up to the day before end. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
working_days | integer | Working days from start to end; negative when end is before start. |
result | date (YYYY-MM-DD) | The date add_days working days away. |
weekday | string | The result's day of the week. |
holidays_skipped | list of object | The holidays on weekdays in the span, which were not counted. |
Examples
Five working days after 21 December 2026 in England
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"
}'
{
"calculator": "date/working-days@1",
"result": {
"result": "2026-12-30",
"weekday": "Wednesday",
"holidays_skipped": [
{
"date": "2026-12-25",
"weekday": "Friday",
"name": "Christmas Day"
},
{
"date": "2026-12-28",
"weekday": "Monday",
"name": "Boxing Day (substitute day)"
}
]
},
"exactness": {},
"precision": null,
"inputs": {
"start": "2026-12-21",
"add_days": 5,
"calendar": "GB-ENG",
"weekend": "sat_sun",
"include_end_date": false
},
"formula": "days in the span that are not a weekend day, a public holiday of the calendar or an extra holiday",
"references": [
{
"title": "5 U.S.C. 6103, as listed by the US Office of Personnel Management",
"url": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/"
},
{
"title": "GOV.UK: UK bank holidays",
"url": "https://www.gov.uk/bank-holidays"
},
{
"title": "Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior",
"url": "https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html"
}
],
"warnings": []
}
US federal working days in July 2026
curl https://api.curatedapi.com/v1/calc/date/working-days \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"start": "2026-07-01",
"end": "2026-07-31",
"calendar": "US",
"include_end_date": true
}'
{
"calculator": "date/working-days@1",
"result": {
"working_days": 22,
"holidays_skipped": [
{
"date": "2026-07-03",
"weekday": "Friday",
"name": "Independence Day (observed)"
}
]
},
"exactness": {},
"precision": null,
"inputs": {
"start": "2026-07-01",
"end": "2026-07-31",
"calendar": "US",
"weekend": "sat_sun",
"include_end_date": true
},
"formula": "days in the span that are not a weekend day, a public holiday of the calendar or an extra holiday",
"references": [
{
"title": "5 U.S.C. 6103, as listed by the US Office of Personnel Management",
"url": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/"
},
{
"title": "GOV.UK: UK bank holidays",
"url": "https://www.gov.uk/bank-holidays"
},
{
"title": "Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior",
"url": "https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html"
}
],
"warnings": []
}
References
- 5 U.S.C. 6103, as listed by the US Office of Personnel Management
- GOV.UK: UK bank holidays
- Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior
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.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.