Reference · built on requestCommons signalEconomic & calendar reference

OpenHolidays API

Public and school holidays for European countries and a few others, by country and subdivision, as JSON or iCal without a key.

Request accessPricing ↗

About

OpenHolidays API is an open data project run by STÜBER SYSTEMS GmbH. It collects public holidays and school holidays from public sources, documents each source, and serves them from openholidaysapi.org over a REST interface described by an OpenAPI definition. Coverage is mostly European, with Brazil, Mexico, and South Africa, and data starts in 2020. Each holiday carries localized names, a start and end date, a type, a nationwide flag, and the subdivisions it applies to. The data is licensed under the ODC Open Database License.

An operator on Fibric reads the holidays for the countries and regions you operate in and proposes cutoffs, promise dates, and staffing changes around them for your approval.

This is a reference listing. It documents what Fibric would read from OpenHolidays API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Public holidays for a country and date range through /PublicHolidays with countryIsoCode, validFrom, validTo, and an optional subdivisionCode
  • School holidays through /SchoolHolidays with the same parameters plus an optional groupCode
  • Every country's holidays on one date through /PublicHolidaysByDate and /SchoolHolidaysByDate
  • Supported countries, their subdivisions, holiday groups, and languages through /Countries, /Subdivisions, /Groups, and /Languages
  • Holiday records with id, localized name, startDate, endDate, nationwide flag, subdivisions, comment, and a type of Public, Bank, Optional, School, BackToSchool, or EndOfLessons
  • iCal (RFC 5545) instead of JSON by sending Accept: text/calendar
  • The oldest and youngest holiday dates held per country through /Statistics/PublicHolidays and /Statistics/SchoolHolidays

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Move the order cutoff ahead of a regional holiday

    Read /PublicHolidays for the warehouse's country and subdivision, find holidays inside the shipping window, and propose an earlier cutoff for the affected days. The record names the holiday and its source.

    With Holiday Cutoff

  • Keep promise dates off non-working days

    Check each promised delivery date against nationwide and subdivision holidays and propose a shifted promise where carriers will not run.

    With Promise Date

  • Pause the SLA clock on public holidays

    Feed the holiday calendar for each support site into the breach forecast so a ticket opened before a holiday is not flagged as late on it.

    With Breach Watch

  • Forecast covers around school holidays

    Pull /SchoolHolidays for the regions your guests travel from and propose a demand adjustment to the cover forecast for those weeks.

    With Cover Forecast

Requirements

  • ISO 3166-1 country codes for the countries you need, and subdivision codes from /Subdivisions for regional holidays
  • Date ranges of three years or less per request; a wider validFrom to validTo returns HTTP 400
  • Compliance with the ODC Open Database License that covers the data
  • An ISO 639-1 language code if you want names in a specific language
Authentication
None. The project is open data, free of charge, and permitted in commercial projects; no key is issued.

Limits

  • Data begins in 2020; earlier years are not held
  • A single request covers at most three years; longer ranges return a 400 validation error
  • Coverage is a fixed list of countries, mostly in Europe; Sweden and Vatican City carry public holidays only
  • No rate limit is published. Data is updated on an ongoing basis and corrections go through the GitHub issue tracker

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request OpenHolidays API ↗

Questions and answers

Which countries does OpenHolidays API cover?
The countries listed on the project site: most of Europe plus Brazil, Mexico, and South Africa, with data from 2020 onward. Most have both public and school holidays; Sweden and Vatican City have public holidays only. /Countries returns the current list with ISO codes.
Can I get the data as a calendar file?
Yes. Send Accept: text/calendar and the API returns iCal (RFC 5545) instead of JSON, which is the default under Accept: text/json. The same query parameters apply.
Is there a limit on the date range?
Yes. A validFrom to validTo range of more than three years is rejected with HTTP 400 and a validation error body. Split longer spans into several requests.
Ask about OpenHolidays API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by OpenHolidays API project, STÜBER SYSTEMS GmbH (openholidaysapi.org). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy