curatedapi
Browse the docs

Guides

Finance

Excel functions

Late payments

E-invoices

Accounting

Number checks

VAT and GST

Billing and pricing

Money and currencies

Dates and time

Math

Unit conversion

Everyday

Health

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

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).

InputTypeDescription
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.

ResultTypeDescription
working_daysintegerWorking days from start to end; negative when end is before start.
resultdate (YYYY-MM-DD)The date add_days working days away.
weekdaystringThe result's day of the week.
holidays_skippedlist of objectThe holidays on weekdays in the span, which were not counted.

Examples

Five working days after 21 December 2026 in England

Requestcurl
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"
  }'
200 OKResponse
{
  "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

Requestcurl
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
  }'
200 OKResponse
{
  "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

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.