Skip to content

Nager.Date API: Check public holiday

Checks whether a date is a public holiday or weekend in a country. By default only nationwide holidays count; give a region to include holidays observed there.

date.nager.at (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by Nager.Date.

Inputs

Values from the run on Oct 31, 2026, shown under Output.

Date, requireddate

Date to check in YYYY-MM-DD format, for example 2026-07-14.

2026-01-06

Region optionalregion

Optional state or province name or subdivision code, for example Bavaria or DE-BY. Omit to check nationwide holidays only.

Bavaria

Default .

Country, requiredcountry

Country name or two-letter country code, for example France or FR.

Germany

Output

From a run on Oct 31, 2026.
{  "date": "2026-01-06",  "region": "Bavaria",  "country": "Germany",  "weekday": "Tuesday",  "holidays": [    {      "regions": [        "Baden-Württemberg",        "Bavaria",        "Saxony-Anhalt"      ],      "page_link": "https://date.nager.at/PublicHoliday/Germany/2026",      "local_name": "Heilige Drei Könige",      "nationwide": false,      "english_name": "Epiphany",      "region_codes": [        "DE-BW",        "DE-BY",        "DE-ST"      ]    }  ],  "is_weekend": false,  "is_public_holiday": true}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
date.nager.at/check_public_holiday
Returns
country, date, weekday, region, is public holiday, is weekend, holidays with names, regions and calendar link

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method date.nager.at/check_public_holiday with the inputs above.

Ask your agent

  • Is 2026-10-03 a public holiday in Germany?
  • Will banks in Quebec be closed on June 24, 2025 for a holiday?
  • Using nager.at, check whether 2025-12-26 is a holiday or weekend in AU-NSW.
  • I'm planning a delivery to Spain on 2026-05-02 in Madrid — is that a day off there?
  • Check on Nager.Date if July 4, 2027 falls on a weekend or public holiday in the US.
  • Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.

    date.nager.at/list_public_holidays
  • Looks up a country on Nager.Date by name or two-letter code and returns its common and official names, code, region and land-border neighbours.

    date.nager.at/get_country_info
  • Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar.

    timeanddate.com/count_business_days
  • Lists GOV.UK bank holidays for a UK region and year, including substitute days and notes, plus the next upcoming holiday. Years GOV.UK does not publish return an empty list and the published years.

    gov.uk/list_bank_holidays
  • Gets daily sunrise, sunset, solar noon, day length and civil twilight for a place from Time and Date, for one or more consecutive days. Times are local with UTC offset; days without sunrise or sunset are marked.

    timeanddate.com/get_sunrise_and_sunset
  • Gets the official ECB euro reference exchange rates for a day, or the latest published day. Weekends, holidays and dates before publication return the previous published day.

    ecb.europa.eu/get_euro_exchange_rates
  • Returns Wikipedia's On this day events, births, deaths and holidays for a month and day, in a chosen Wikipedia language; events, births and deaths come newest year first.

    wikipedia.org/get_on_this_day
  • Converts a meeting time in one city to local times in other cities, with time zones and 09:00-17:00 working-hours status. Supports dates from 1970 to 2030; ambiguous clock-change times use the first occurrence.

    timeanddate.com/convert_time_between_cities