Business days and public holidays for 200 countries and territories
Add business days to a date, count working days between two dates, compute an SLA deadline in business hours, or list holidays by year and region. Precomputed for 2000 through 2060, regional holidays for 20 countries. One GET request, JSON back.
GET /v1/businessdays/sla?country=DE®ion=DE-BY&start=2027-03-05T16:40:00%2B01:00&offset=3&unit=days{
"country": "DE",
"region": "DE-BY",
"start": "2027-03-05T16:40:00+01:00",
"deadline": "2027-03-10T16:40:00+01:00",
"businessDaysUsed": 3,
"weekendDaysSkipped": 2,
"holidaysSkipped": 0
}What it does
State and province level
Regional holidays for Australia, Brazil, Canada, Chile, Germany, India, Malaysia, New Zealand, Pakistan, Portugal, Spain, Switzerland, the United Kingdom, the United States and six more. Pass a region code and Bavaria stops sharing Berlin's calendar.
Business-day arithmetic, not just a holiday list
Add or subtract business days, count working days in a range, and compute deadlines in business hours with your own working-day window. Weekend definitions follow each country.
Sixty years, precomputed
Every calendar from 2000 to 2060 is generated ahead of time and served from memory. No upstream calls at request time, so responses are fast and the same input always returns the same answer.
Calendar feeds
Every country and region is also available as an iCalendar feed you can subscribe to in Google Calendar, Outlook or any scheduling tool.
Endpoints
| Method | Path | Summary |
|---|---|---|
| GET | /v1/holidays/{country}/{year} |
Holidays for a country and year. Filter by region, type and language. |
| GET | /v1/businessdays/add |
Move a date forward or back by a number of business days. |
| GET | /v1/businessdays/between |
Count business days, weekend days and holidays between two dates. |
| GET | /v1/businessdays/sla |
Deadline after N business days or business hours from a start time. |
| GET | /v1/holidays/{country}/{year}.ics |
iCalendar feed for a country, year and optional region. |
| GET | /countries |
Supported countries and how many regions each one has. |
Pricing
Basic
For one application or an internal tool.
Subscribe on RapidAPIPro
For products that compute dates on every request.
Subscribe on RapidAPIUltra
For batch jobs and high-traffic services.
Subscribe on RapidAPI- Subscriptions are handled by RapidAPI: sign in there, pick a plan, and your RapidAPI key works immediately.
- Requests above the plan limit return HTTP 429 until the next billing cycle. Upgrade on RapidAPI to lift the limit at once.
- Direct billing with lower prices is coming; the RapidAPI plans will keep working unchanged.
Questions
Where does the holiday data come from?
The base calendars are generated from the last MIT-licensed release of the Nager.Date project, and countries added since are filled from the date-holidays dataset (ISC and CC BY 3.0, attribution on this page). Both sources are reviewed before a country ships.
Is coverage the same for every country?
No, and the API says so. Every entry in /countries carries a coverage field: full means the national list is complete and reviewed through 2060; partial means the national list is known to be incomplete or lunar-calendar holidays are missing for some years. India, Thailand and Malaysia are partial today and are being upgraded. Check the flag before relying on a country for payroll or legal deadlines.
Are holidays listed on the observed date?
Yes. When a holiday falls on a weekend and the country observes it on a weekday, the observed date is what the API returns, because that is the day offices are closed.
How are weekends defined?
Per country. Most use Saturday and Sunday. Countries with a Friday and Saturday weekend are handled without any configuration on your side.
What happens if a government changes a holiday?
Calendars are regenerated when upstream data changes, and the change is noted in the changelog. Historical years never change.
Is there an SLA?
The API runs on Deno Deploy across multiple regions. There is no contractual uptime guarantee on these plans. Incidents are recorded in the changelog.
Data sources
Holiday data derived from Nager.Date (MIT, snapshot 2024-02-22) and date-holidays (ISC and CC BY 3.0). Business-day logic, regional coverage and the precomputed calendars are the work of Polystash.
Data sources and attribution
Holiday calendars in data/countries/ come from two upstream projects. Both require attribution; this file is the canonical notice and its contents are reproduced on the public API documentation page.
Nager.Date
- Project: https://github.com/nager/Nager.Date
- Snapshot used: commit
07b2f47(2024-02-22), the last release published under the MIT licence before the project moved to a sponsor-key model. - Licence: MIT.
- Covers the 110 countries generated by
tools/exporter.
date-holidays
- Project: https://github.com/commenthol/date-holidays
- Package:
npm:date-holidays - Licence: ISC for the code, CC-BY-3.0 for the holiday data (https://creativecommons.org/licenses/by/3.0/). Attribution is required and is given here and in the API documentation.
- Covers every country generated by
tools/augment, i.e. the countries the Nager.Date snapshot does not include.
Neither upstream project endorses this API. Holiday data is provided as-is and should not be relied on as a legal source for payroll or contractual deadlines.