# 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. Unofficial. Not affiliated with or endorsed by Nager.Date. - Page: https://fous.com/methods/date.nager.at/check-public-holiday - Method: `date.nager.at/check_public_holiday`, version 1 - Website: date.nager.at - Returns: country, date, weekday, region, is public holiday, is weekend, holidays with names, regions and calendar link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `date` | string | yes | `"2026-01-06"` | Date to check in YYYY-MM-DD format, for example 2026-07-14. | | `region` | string | no | `"Bavaria"` | Optional state or province name or subdivision code, for example Bavaria or DE-BY. Omit to check nationwide holidays only. Default "". | | `country` | string | yes | `"Germany"` | Country name or two-letter country code, for example France or FR. | ## Output From a run on Oct 31, 2026. Its input: ```json { "date": "2026-01-06", "region": "Bavaria", "country": "Germany" } ``` Its output: ```json { "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 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"date.nager.at/check_public_holiday","input":{"date":"2026-01-06","region":"Bavaria","country":"Germany"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## 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. ## Input schema ```json { "type": "object", "required": [ "country", "date" ], "properties": { "date": { "type": "string", "description": "Date to check in YYYY-MM-DD format, for example 2026-07-14." }, "region": { "type": "string", "default": "", "description": "Optional state or province name or subdivision code, for example Bavaria or DE-BY. Omit to check nationwide holidays only." }, "country": { "type": "string", "description": "Country name or two-letter country code, for example France or FR." } } } ``` ## Output schema ```json { "type": "object", "required": [ "country", "date", "weekday", "region", "is_public_holiday", "is_weekend", "holidays" ], "properties": { "date": { "type": "string", "format": "date", "description": "Date checked." }, "region": { "type": [ "string", "null" ], "description": "Region checked, or null for nationwide only." }, "country": { "type": "string", "description": "Country name." }, "weekday": { "type": "string", "description": "Day of the week." }, "holidays": { "type": "array", "items": { "type": "object", "required": [ "english_name", "local_name", "nationwide", "regions", "region_codes", "page_link" ], "properties": { "regions": { "type": "array", "items": { "type": "string" }, "description": "Regions where a regional holiday applies; empty for nationwide holidays." }, "page_link": { "type": "string", "description": "Page for the country's holiday calendar." }, "local_name": { "type": "string", "description": "Holiday name in the local language." }, "nationwide": { "type": "boolean", "description": "Whether the holiday applies nationwide." }, "english_name": { "type": "string", "description": "Holiday name in English." }, "region_codes": { "type": "array", "items": { "type": "string" }, "description": "Official subdivision codes for applicable regions." } }, "additionalProperties": false }, "description": "Applicable public holidays on the date; empty if none." }, "is_weekend": { "type": "boolean", "description": "Whether the date falls on Saturday or Sunday." }, "is_public_holiday": { "type": "boolean", "description": "Whether the date has an applicable public holiday." } }, "additionalProperties": false } ``` ## See more - [Nager.Date API: List public holidays](https://fous.com/methods/date.nager.at/list-public-holidays.md): Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types. - [Nager.Date API: Get country info](https://fous.com/methods/date.nager.at/get-country-info.md): 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. - [Time and Date API: Count business days](https://fous.com/methods/timeanddate.com/count-business-days.md): 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. - [GOV.UK API: List bank holidays](https://fous.com/methods/gov.uk/list-bank-holidays.md): 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. - [Time and Date API: Get sunrise and sunset](https://fous.com/methods/timeanddate.com/get-sunrise-and-sunset.md): 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. - [European Union API: Get euro exchange rates](https://fous.com/methods/ecb.europa.eu/get-euro-exchange-rates.md): 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. - [Wikipedia API: Get Wikipedia On this day](https://fous.com/methods/wikipedia.org/get-on-this-day.md): 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. - [Time and Date API: Convert time between cities](https://fous.com/methods/timeanddate.com/convert-time-between-cities.md): 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. - [All Nager.Date methods](https://fous.com/methods/nager.at.md)