Holiday data API
Machine-readable public holiday dates and chain opening hours, served as static JSON
files. Free to use for personal and small projects; attribution via CC BY 4.0.
A commercial tier with live freshness and higher limits is on the roadmap.
Endpoints
GET /api/holidays.json List of supported countries with their calendar URLs.
curl https://openonholiday.com/api/holidays.json
GET /api/holidays/{country}.json All official holiday dates for a country (2025–2030).
curl https://openonholiday.com/api/holidays/nl.json
GET /api/holidays/{country}/{year}.json Holiday dates for a single year.
curl https://openonholiday.com/api/holidays/gb/2026.json
GET /api/chains/{country}.json Chain opening hours per holiday, with last-verified dates.
curl https://openonholiday.com/api/chains/us.json
Countries
- Netherlands
- Thailand
- United Kingdom
- Germany
- United States
- Belgium
- France
- Spain
- Italy
- Australia
- Singapore
- Philippines
- Canada
- New Zealand
- Ireland
- Austria
- Switzerland
- Portugal
- Sweden
- Denmark
- Norway
- Finland
- Poland
- Czechia
- Greece
- Turkey
- Japan
- India
- Malaysia
- Hong Kong
- Mexico
- Brazil
- Luxembourg
- Macao
- Qatar
- Brunei
- Taiwan
- San Marino
- United Arab Emirates
- Guyana
- Iceland
- Malta
- Saudi Arabia
- Bahrain
- South Korea
- Cyprus
- Slovenia
- Lithuania
- Israel
- Kuwait
- Croatia
- Russia
Attribution: holiday dates aggregated from official calendars (via Nager.Date and Google Calendar), licensed CC BY 4.0. Chain hours are verified by the openonholiday.com editorial team. For commercial terms contact us.