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 run

Example results

Date: 2026-07-14
Region: Not provided
Country: France
Weekday: Tuesday
Is Weekend: No
Is Public Holiday: Yes
Holidays: Holidays
Regions Page Link Local Name Nationwide English Name Region Codes
None
date.nager.at
Fête nationale
Yes
Bastille Day
None

Holidays
Regions	Page Link	Local Name	Nationwide	English Name	Region Codes
None	date.nager.at	Fête nationale	Yes	Bastille Day	None

Example data · Run in Studio for fresh results.

About Nager.Date

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 by Fous from date.nager.at and checked automatically; it last passed a check on Sep 30, 2026. Fous is not affiliated with Nager.Date.

Actions

Check public holiday

1 credit per run

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 per run

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 per run

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 per run

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 per run

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

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with Nager.Date?

No. Fous is not affiliated with Nager.Date. This workflow reads the public date.nager.at website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 30, 2026.