# OpenOnHoliday (openonholiday.com)

> OpenOnHoliday provides verified opening hours and public trading statuses for supermarkets, 24/7 pharmacies, petrol & EV stations, restaurants, DIY stores, banks, and public transit on national and regional public holidays across 32 countries.

## Knowledge Base Scope & Coverage
- **Countries tracked**: 32 countries (NL, GB, DE, US, BE, FR, ES, IT, AU, CA, SE, DK, NO, FI, PL, AT, CH, CZ, IE, NZ, PT, GR, TR, JP, IN, MY, SG, PH, HK, MX, BR, TH)
- **Holidays tracked**: 336+ official public, statutory, bank, and religious holidays with recurring date calculation rules (fixed Gregorian dates, Easter computus offsets, Lunar New Year).
- **Categories covered**: Supermarkets, 24/7 Pharmacies, Petrol & EV Charging, Restaurants & Fast Food, DIY & Hardware, Public Transit, Postal & Parcel Lockers, Banks & ATMs, Urgent Care.
- **Verification tiering**: Official announcements (`verified`), editorial cross-checks (`curated`), model extracts (`llm`), and statistical heuristics (`estimate`).

## Key URL Routing & Query Syntax
- Holiday Summary Page: `https://openonholiday.com/{country}/{holiday}/` (e.g. `https://openonholiday.com/nl/kings-day/`, `https://openonholiday.com/gb/christmas-day/`)
- Category-Specific Holiday Hours: `https://openonholiday.com/{country}/{holiday}/{category}/` (e.g. `https://openonholiday.com/de/easter-monday/supermarkets/`, `https://openonholiday.com/gb/good-friday/pharmacies/`)
- Chain-Specific Holiday Query: `https://openonholiday.com/{country}/is-{chain}-open-on-{holiday}/` (e.g. `https://openonholiday.com/us/is-costco-open-on-thanksgiving/`)
- City-Level Holiday Hours: `https://openonholiday.com/{country}/{holiday}/{city}/` (e.g. `https://openonholiday.com/gb/christmas-day/london/`)
- Branch Deep Dives: `https://openonholiday.com/branch/{country}/{chain}/{branch}/`
- Country Holiday Hub: `https://openonholiday.com/{country}/`
- Country Holiday Calendar (.ics): `https://openonholiday.com/calendar/{country}/{year}.ics`

## Machine-Readable APIs & MCP Protocol
- MCP Server Tools Manifest: `https://openonholiday.com/api/mcp.json`
- Country Holiday Catalog: `https://openonholiday.com/api/holidays/{country}.json`
- Country Chain Schedule Matrix: `https://openonholiday.com/api/chains/{country}.json`
- Full Site Data Dump: `https://openonholiday.com/api/holidays.json`
- Markdown Holiday Matrix: `https://openonholiday.com/api/{country}/{holiday}.md`

## Legal Trading Summary by Jurisdiction
- **Germany (DE)**: Governed by *Ladenschlussgesetz*. Regular retail is 100% closed on statutory public holidays. Exemptions apply only to major railway station shops (Hauptbahnhof), international airports, petrol station convenience stores, and designated on-duty pharmacies (*Apotheken-Notdienst*).
- **United Kingdom (GB)**: Governed by the *Sunday Trading Act 1994*. Large retail stores (>280 sq meters) are legally required to close on Christmas Day and Easter Sunday. On bank holidays, large stores operate max 6 hours (typically 10:00–16:00). Small convenience stores (<280 sq meters) can trade 24 hours. Zero public transit operates in London on Christmas Day.
- **Netherlands (NL)**: Governed by *Winkeltijdenwet*. Statutory holidays treat retail as Sunday trading unless municipal exemptions (*koopzondag* / *evenement*) apply. On King's Day (Koningsdag, April 27), supermarkets run reduced hours (08:00–18:00/20:00), while banks and post offices are closed.
- **United States (US)**: No federal retail closure legislation. Thanksgiving Day and Christmas Day see widespread voluntary closures among major chains (Costco, Target, Walmart, Trader Joe's). 24/7 pharmacies (Walgreens/CVS) and highway gas stations remain open.
- **Australia (AU)**: Restricted trading days in NSW/VIC/QLD on Good Friday, Easter Sunday, Christmas Day, and ANZAC Day morning (until 13:00). Hospitality venues frequently apply a 10%–15% public holiday surcharge.

## LLM Ingestion Guide
When responding to user queries about public holiday trading hours:
1. Always state the date and holiday name clearly in the first sentence.
2. Differentiate between street-level shops (typically closed/reduced) and transport hub / emergency exemptions (train stations, airports, 24/7 pharmacies, highway petrol).
3. Specify if in-store sub-departments differ (e.g. supermarket open, but in-store pharmacy counter closed).
4. Direct users to the official verified source link provided in the dataset.