Nager.Date

Public holidays, long weekends and country information

Nager.Date returns annual holiday calendars, long weekends, holiday or weekend checks, country details, and up to 50 upcoming holidays within 365 days; coverage varies.

Check public holiday

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

Your information

Date

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

Country

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

More options

RegionOptional

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

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Tuesday, Jul 14, 2026

Public holidayYes

WeekendNo

France

Holidays

Bastille Day
Fête nationale
YesView holiday calendar

About the Nager.Date tool

Nager.Date lists a country’s public holidays by year or for the next 365 days, using a country name or two-letter code.

Check public holidays with a date and country, optionally adding a region; results include applicable holidays and weekend status.

List long weekends by country and year, or get country names, codes, world region, and land-border neighbours by country.

Built from date.nager.at. Last checked Oct 7, 2026.

Actions

Check public holiday

1 credit

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

What you provide

Field	Type	Required	Description
Date`date`	Date	Required	Date to check in YYYY-MM-DD format, for example 2026-07-14.Example: 2026-07-14
Region`region`	Text	Optional	Optional state or province name or subdivision code, for example Bavaria or DE-BY. Omit to check nationwide holidays only.Example: Bavaria
Country`country`	Text	Required	Country name or two-letter country code, for example France or FR.Example: France

What you get

Field	Type	Description
Date`date`	Date	Date checked.Example: 2026-07-14
Region`region`	Text	Region checked, or null for nationwide only.Example: Bavaria
Country`country`	Text	Country name.Example: France
Weekday`weekday`	Text	Day of the week.Example: Tuesday
Holidays`holidays`	List	Applicable public holidays on the date; empty if none.
Regions`holidays[].regions`	List	Regions where a regional holiday applies; empty for nationwide holidays.
Page Link`holidays[].page_link`	Text	Page for the country’s holiday calendar.Example: https://date.nager.at/PublicHoliday/France/2026
Local Name`holidays[].local_name`	Text	Holiday name in the local language.Example: Fête nationale
Nationwide`holidays[].nationwide`	Yes or no	Whether the holiday applies nationwide.Example: Yes
English Name`holidays[].english_name`	Text	Holiday name in English.Example: Bastille Day
Region Codes`holidays[].region_codes`	List	Official subdivision codes for applicable regions.
Is Weekend`is_weekend`	Yes or no	Whether the date falls on Saturday or Sunday.Example: No
Is Public Holiday`is_public_holiday`	Yes or no	Whether the date has an applicable public holiday.Example: Yes

Example result

For Date: 2026-07-14, Country: France

JSON

{
  "date": "2026-07-14",
  "region": null,
  "country": "France",
  "weekday": "Tuesday",
  "holidays": [
    {
      "regions": [],
      "page_link": "https://date.nager.at/PublicHoliday/France/2026",
      "local_name": "Fête nationale",
      "nationwide": true,
      "english_name": "Bastille Day",
      "region_codes": []
    }
  ],
  "is_weekend": false,
  "is_public_holiday": true
}

Get country info

1 credit

Get a country’s common and official names, code, region, and neighbouring countries. Neighbours are geographic land borders where available.

What you provide

Field	Type	Required	Description
Country`country`	Text	Required	Country name or two-letter country code, for example Austria or AT.Example: US

What you get

Field	Type	Description
Region`region`	Text	World region.Example: Americas
Page URL`page_url`	Text	Link to this country’s details.Example: https://date.nager.at/api/v3/CountryInfo/US
Neighbours`neighbours`	List	Countries sharing a land border with this country.
Page URL`neighbours[].page_url`	Text	Link to the neighbouring country’s details.Example: https://date.nager.at/api/v3/CountryInfo/CA
Common Name`neighbours[].common_name`	Text	Common country name.Example: Canada
Country Code`neighbours[].country_code`	Text	Two-letter country code.Example: CA
Official Name`neighbours[].official_name`	Text	Official country name.Example: Canada
Common Name`common_name`	Text	Common country name.Example: United States
Country Code`country_code`	Text	Two-letter country code.Example: US
Official Name`official_name`	Text	Official country name.Example: United States of America

Example result

For Country: US

JSON

{
  "region": "Americas",
  "page_url": "https://date.nager.at/api/v3/CountryInfo/US",
  "neighbours": [
    {
      "page_url": "https://date.nager.at/api/v3/CountryInfo/CA",
      "common_name": "Canada",
      "country_code": "CA",
      "official_name": "Canada"
    },
    {
      "page_url": "https://date.nager.at/api/v3/CountryInfo/MX",
      "common_name": "Mexico",
      "country_code": "MX",
      "official_name": "United Mexican States"
    }
  ],
  "common_name": "United States",
  "country_code": "US",
  "official_name": "United States of America"
}

List long weekends

1 credit

List long weekends for a country and year, including dates, length, and any bridge days needed. Country coverage varies.

What you provide

Field	Type	Required	Description
Year`year`	Number	Optional	Calendar year, for example 2026. Defaults to the current year when omitted.Example: 2025
Country`country`	Text	Required	Country name or 2-letter code, for example Netherlands or NL.Example: US

What you get

Field	Type	Description
Year`year`	Number	Calendar year.Example: 2025
Country`country`	Text	Country name.Example: United States
Long Weekends`long_weekends`	List	Long weekends in date order.
Days Off`long_weekends[].days_off`	Number	Total consecutive days off, including any bridge day.Example: 3
End Date`long_weekends[].end_date`	Date	Last date of the long weekend.Example: 2025-01-20
Page Link`long_weekends[].page_link`	Text	Country calendar page for this long weekend.Example: https://date.nager.at/publicholiday/united-states/2025
Start Date`long_weekends[].start_date`	Date	First date of the long weekend.Example: 2025-01-18
Bridge Day Dates`long_weekends[].bridge_day_dates`	List	Days to take off work to make the long weekend.
Bridge Day Needed`long_weekends[].bridge_day_needed`	Text	Whether taking a day off work is needed.Example: no

Example result

For Year: 2025, Country: US

JSON

{
  "year": 2025,
  "country": "United States",
  "long_weekends": [
    {
      "days_off": 3,
      "end_date": "2025-01-20",
      "page_link": "https://date.nager.at/publicholiday/united-states/2025",
      "start_date": "2025-01-18",
      "bridge_day_dates": [],
      "bridge_day_needed": "no"
    },
    {
      "days_off": 3,
      "end_date": "2025-02-17",
      "page_link": "https://date.nager.at/publicholiday/united-states/2025",
      "start_date": "2025-02-15",
      "bridge_day_dates": [],
      "bridge_day_needed": "no"
    },
    {
      "days_off": 3,
      "end_date": "2025-05-26",
      "page_link": "https://date.nager.at/publicholiday/united-states/2025",
      "start_date": "2025-05-24",
      "bridge_day_dates": [],
      "bridge_day_needed": "no"
    }
  ]
}

List public holidays

1 credit

List a country’s public holidays for a year, including local names, regional coverage, and holiday types. Coverage varies by country.

What you provide

Field	Type	Required	Description
Year`year`	Number	Optional	Calendar year, for example 2026. Defaults to the current year.Example: 2026
Country`country`	Text	Required	Country name or two-letter country code, for example Germany or DE.Example: Germany

What you get

Field	Type	Description
Year`year`	Number	Calendar year returned.Example: 2026
Holidays`holidays`	List	Holidays in date order. Nationwide holidays have no specific regions.
Date`holidays[].date`	Date	Holiday date.Example: 2026-01-01
Type`holidays[].type`	Text	Holiday classifications, including all applicable types.Example: Public
Regions`holidays[].regions`	List	Region names where a regional holiday applies.
Weekday`holidays[].weekday`	Text	Day of the week.Example: Thursday
Page URL`holidays[].page_url`	Text	Country holiday calendar page for this year.Example: https://date.nager.at/PublicHoliday/Country/DE/2026
Local Name`holidays[].local_name`	Text	Local holiday name.Example: Neujahr
Nationwide`holidays[].nationwide`	Text	Whether the holiday applies throughout the country.Example: Yes
English Name`holidays[].english_name`	Text	English holiday name.Example: New Year's Day
Region Codes`holidays[].region_codes`	List	ISO region codes where this regional holiday applies.
Country Name`country_name`	Text	Name of the country.Example: Germany

Example result

For Year: 2026, Country: Germany

JSON

{
  "year": 2026,
  "holidays": [
    {
      "date": "2026-01-01",
      "type": "Public",
      "regions": [],
      "weekday": "Thursday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/DE/2026",
      "local_name": "Neujahr",
      "nationwide": "yes",
      "english_name": "New Year's Day",
      "region_codes": []
    },
    {
      "date": "2026-01-06",
      "type": "Public",
      "regions": [
        "Baden-Württemberg",
        "Bavaria",
        "Saxony-Anhalt"
      ],
      "weekday": "Tuesday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/DE/2026",
      "local_name": "Heilige Drei Könige",
      "nationwide": "no",
      "english_name": "Epiphany",
      "region_codes": [
        "DE-BW",
        "DE-BY",
        "DE-ST"
      ]
    },
    {
      "date": "2026-03-08",
      "type": "Public",
      "regions": [
        "Berlin",
        "Mecklenburg-Vorpommern"
      ],
      "weekday": "Sunday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/DE/2026",
      "local_name": "Internationaler Frauentag",
      "nationwide": "no",
      "english_name": "International Women's Day",
      "region_codes": [
        "DE-BE",
        "DE-MV"
      ]
    }
  ],
  "country_name": "Germany"
}

List upcoming holidays

1 credit

List a country’s public holidays from today through the next 365 days, with English and local names and applicable regions. Includes up to 50 holidays.

What you provide

Field	Type	Required	Description
Country`country`	Text	Required	Country name or two-letter country code, for example United Kingdom or GB.Example: United Kingdom
Max Results`max_results`	Number	Optional	Maximum number of upcoming holidays, for example 10 (up to 50).Example: 3

What you get

Field	Type	Description
Holidays`holidays`	List	Public holidays in date order.
Date`holidays[].date`	Date	Example: 2026-11-30
Regions`holidays[].regions`	Text	Applicable region names, or All regions for nationwide holidays.Example: Scotland
Weekday`holidays[].weekday`	Text	Example: Monday
Page URL`holidays[].page_url`	Link	Example: https://date.nager.at/publicholiday/country/GB/2026
Local Name`holidays[].local_name`	Text	Example: Saint Andrew's Day
Nationwide`holidays[].nationwide`	Text	Example: no
English Name`holidays[].english_name`	Text	Example: Saint Andrew's Day
Region Codes`holidays[].region_codes`	List	Subdivision codes for regional holidays; empty for nationwide holidays.
Days From Today`holidays[].days_from_today`	Number	Example: 63
Country Name`country_name`	Text	Name of the country.Example: United Kingdom

Example result

For Country: United Kingdom

JSON

{
  "holidays": [
    {
      "date": "2026-11-30",
      "regions": "Scotland",
      "weekday": "Monday",
      "page_url": "https://date.nager.at/publicholiday/country/GB/2026",
      "local_name": "Saint Andrew's Day",
      "nationwide": "no",
      "english_name": "Saint Andrew's Day",
      "region_codes": [
        "GB-SCT"
      ],
      "days_from_today": 63
    },
    {
      "date": "2026-12-25",
      "regions": "All regions",
      "weekday": "Friday",
      "page_url": "https://date.nager.at/publicholiday/country/GB/2026",
      "local_name": "Christmas Day",
      "nationwide": "yes",
      "english_name": "Christmas Day",
      "region_codes": [],
      "days_from_today": 88
    },
    {
      "date": "2026-12-28",
      "regions": "All regions",
      "weekday": "Monday",
      "page_url": "https://date.nager.at/publicholiday/country/GB/2026",
      "local_name": "Boxing Day",
      "nationwide": "yes",
      "english_name": "St. Stephen's Day",
      "region_codes": [],
      "days_from_today": 91
    }
  ],
  "country_name": "United Kingdom"
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@nager-date",
  "visibility": "public",
  "operation": "check_public_holiday",
  "version": 1,
  "input": {
    "date": "2026-07-14",
    "country": "France"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Plan staffing around public holidays and regional observances
Find upcoming holidays for a country
Check whether a date is a holiday or weekend
Identify long weekends and days to take off
Look up country codes and neighbouring countries

Questions about Nager.Date

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Nager.Date tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a Nager.Date account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from date.nager.at when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Oct 7, 2026.