Lumeo APIs
Data

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 playground

Public Holidays API

Reliable holiday data for scheduling, HR, logistics and travel products.

📅 Holidays

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

EndpointWhat it returns
GET/holidaysHolidays 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/nextUpcoming holidays
The next holidays of a country from today, each with days remaining.
GET/holidays/checkIs 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/worldwideHolidays worldwide this week
Public holidays around the world in the next days, grouped by date.
GET/holidays/compareCompare countries
Nationwide holidays of 2-8 countries side by side for a year, flagging the dates when all of them are off.
GET/long-weekendsLong weekends
Long weekends of a year for a country (3+ days off), including those that need a bridge day.
GET/countriesSupported countries
All supported countries with their ISO codes.
GET/countryCountry 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'

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 RapidAPI

Related APIs

Data

GitHub Trending API

GitHub trending repositories & developers (daily/weekly/monthly): stars, forks, stars gained, language, contributors. Filter by language.

Data

App Store & Google Play API

App Store & Google Play data: app details, ratings & histogram, installs, versions, screenshots, search, reviews with replies, top charts. Any country.

Data

Google Trends API

Real-time Google Trends: full Trending Now list for 125+ countries with search volume, growth %, categories, related queries, news stories, topics.