Public Holidays API - 120+ Countries
Public & bank holidays for 120+ countries: by year, next holidays, is-it-a-holiday check, regional holidays, long weekends and country comparison.
Get a free API key on RapidAPI Try it in the playgroundPublic Holidays API
Reliable holiday data for scheduling, HR, logistics and travel products.
📅 Holidays
- By country and year (1975–2075) with English and local names, weekday, nationwide vs. regional (states / provinces), and type (public, bank, school, optional, observance)
- Next holidays with days remaining
- Is this date a holiday? — plus weekend and business-day flags
- Worldwide: who is off in the next 7 days
- Compare countries: find the days when several countries are closed — perfect for distributed teams
🌴 Long weekends
Every long weekend of the year, including those you can create by taking bridge days.
🌍 Countries
Supported countries, official and native names, region, borders and holiday statistics.
Use cases: calendars & booking systems · delivery-date and SLA calculators · payroll & HR · travel planning · market / support-desk availability · e-commerce campaigns
Keywords: public holidays api, bank holidays api, holiday calendar, national holidays, is today a holiday, business days, working days, long weekends, bridge days, holidays by country
Endpoints (8)
| Endpoint | What it returns |
|---|---|
GET/holidays | Holidays by country & year All holidays of a country for a year, optionally one month, one holiday type or one region (regional + nationwide holidays). |
GET/holidays/next | Upcoming holidays The next holidays of a country from today, each with days remaining. |
GET/holidays/check | Is it a holiday? Check a date (default: today) in a country: nationwide public holiday, regional holiday, weekend and business-day flags, plus the next holiday after it. |
GET/holidays/worldwide | Holidays worldwide this week Public holidays around the world in the next days, grouped by date. |
GET/holidays/compare | Compare countries Nationwide holidays of 2-8 countries side by side for a year, flagging the dates when all of them are off. |
GET/long-weekends | Long weekends Long weekends of a year for a country (3+ days off), including those that need a bridge day. |
GET/countries | Supported countries All supported countries with their ISO codes. |
GET/country | Country info Official and native name, region, bordering countries, flag emoji, holiday counts for the current year and the next holiday. |
Quick start
Subscribe on RapidAPI (free plan available), copy your key, and call GET /holidays:
curl --request GET \
--url 'https://public-holidays-api-120-countries.p.rapidapi.com/holidays?country=DE&year=2026&month=12' \
--header 'x-rapidapi-host: public-holidays-api-120-countries.p.rapidapi.com' \
--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'import requests
url = "https://public-holidays-api-120-countries.p.rapidapi.com/holidays?country=DE&year=2026&month=12"
headers = {
"x-rapidapi-host": "public-holidays-api-120-countries.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY",
}
resp = requests.get(url, headers=headers)
print(resp.json())const res = await fetch("https://public-holidays-api-120-countries.p.rapidapi.com/holidays?country=DE&year=2026&month=12", {
method: "GET",
headers: {
"x-rapidapi-host": "public-holidays-api-120-countries.p.rapidapi.com",
"x-rapidapi-key": "YOUR_RAPIDAPI_KEY"
}
});
console.log(await res.json());
Example response
{
"country_code": "DE",
"year": 2026,
"count": 2,
"holidays": [
{
"date": "2026-12-25",
"weekday": "Friday",
"name": "Christmas Day",
"local_name": "Erster Weihnachtstag",
"country_code": "DE",
"nationwide": true,
"regions": null,
"types": [
"Public"
],
"fixed_date": false,
"since_year": null,
"is_weekend": false
},
{
"date": "2026-12-26",
"weekday": "Saturday",
"name": "St. Stephen's Day",
"local_name": "Zweiter Weihnachtstag",
"country_code": "DE",
"nationwide": true,
"regions": null,
"types": [
"Public"
],
"fixed_date": false,
"since_year": null,
"is_weekend": true
}
]
}
Start free. Every plan includes all endpoints; upgrade only when you need more requests. Runs on Cloudflare's global network for low latency worldwide.
Subscribe on RapidAPIRelated APIs
GitHub Trending API
GitHub trending repositories & developers (daily/weekly/monthly): stars, forks, stars gained, language, contributors. Filter by language.
DataApp Store & Google Play API
App Store & Google Play data: app details, ratings & histogram, installs, versions, screenshots, search, reviews with replies, top charts. Any country.
DataGoogle Trends API
Real-time Google Trends: full Trending Now list for 125+ countries with search volume, growth %, categories, related queries, news stories, topics.