Skip to content

Nager.Date API: List public holidays

Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.

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 23, 2026, shown under Output.

Year optionalyear

Calendar year, for example 2026. Defaults to the current year.

Not set

Whole number from 1 to 9999.

Country, requiredcountry

Country name or two-letter country code, for example Germany or DE.

US

Output

From a run on Oct 23, 2026, shortened for this page.
{  "year": 2026,  "holidays": [    {      "date": "2026-01-01",      "type": "Public, Bank",      "regions": [],      "weekday": "Thursday",      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",      "local_name": "New Year's Day",      "nationwide": "yes",      "english_name": "New Year's Day",      "region_codes": []    },    {      "date": "2026-01-19",      "type": "Public, Bank",      "regions": [],      "weekday": "Monday",      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",      "local_name": "Martin Luther King, Jr. Day",      "nationwide": "yes",      "english_name": "Martin Luther King, Jr. Day",      "region_codes": []    },    {      "date": "2026-02-12",      "type": "Observance",      "regions": [        "California",        "Connecticut",        "Illinois"      ],      "weekday": "Thursday",      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",      "local_name": "Lincoln's Birthday",      "nationwide": "no",      "english_name": "Lincoln's Birthday",      "region_codes": [        "US-CA",        "US-CT",        "US-IL"      ]    }  ],  "country_name": "United States"}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
date.nager.at/list_public_holidays
Returns
date, weekday, English and local names, regions, type, nationwide flag

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/list_public_holidays with the inputs above.

Ask your agent

  • What public holidays fall in Germany in 2026, and which ones apply only to certain states?
  • I need a list of Japan's national holidays for 2025 with their local names in Japanese.
  • Which days are bank holidays in the UK this year, and are any of them regional rather than nationwide?
  • Show me the public holidays for DE in 2027 including the weekday for each date.
  • Can you give me the French public holidays for 2024 along with their holiday types?
  • 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/check_public_holiday
  • 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
  • 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
  • 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
  • Gets a Formula 1 season calendar with venues, sprint weekends, status, and session start times in circuit local time or a chosen city or IANA time zone.

    formula1.com/get_race_calendar
  • Lists statewide ballot measures in a US state and year, in Ballotpedia order, with election dates, topics, measure types, yes/no vote meanings and results. Years without statewide measures return an empty list.

    ballotpedia.org/list_ballot_measures
  • Lists Nasdaq dividend calendar entries going ex-dividend on a day (US Eastern), sorted by company name. Includes ETFs and other listed securities shown by Nasdaq; dividend yield is not shown by this calendar and is null.

    nasdaq.com/get_dividend_calendar
  • 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