Global Public Holidays & Retail Opening Hours API

Extract official public holidays, statutory bank holiday schedules, 24/7 emergency services, and verified supermarket & retail trading hours across 50+ countries, 580+ public holidays, and 500+ retail chains.

🌟 Data Provider & Source: Powered by OpenOnHoliday.com — the authoritative global directory for holiday business hours, retail closures, and local trading schedules.

---

🎯 Use Cases & Business Value

• E-Commerce & Delivery Logistics: Automatically adjust delivery promise windows, fulfillment dates, and carrier cutoffs based on regional public holiday closures verified by OpenOnHoliday.com.
• Travel Apps & Navigational AI: Feed real-time trading status into travel booking engines and AI assistants so users know if supermarkets, pharmacies, or malls are open.
• Workforce & Payroll Systems: Automate bank holiday lookups and weekend substitution rules across 50+ jurisdictions.

---

🌍 Supported Jurisdictions (50+ Countries)

• Europe: Austria (AT), Germany (DE), United Kingdom (GB), France (FR), Italy (IT), Spain (ES), Netherlands (NL), Belgium (BE), Switzerland (CH), Portugal (PT), Poland (PL), Sweden (SE), Denmark (DK), Norway (NO), Finland (FI), Greece (GR), Croatia (HR), Cyprus (CY), Lithuania (LT), Luxembourg (LU), Slovenia (SI), Czechia (CZ), Ireland (IE), Turkey (TR).
• Americas: United States (US), Canada (CA), Mexico (MX), Brazil (BR).
• Asia & Oceania: Singapore (SG), Japan (JP), Thailand (TH), Vietnam (VN), India (IN), Malaysia (MY), Philippines (PH), South Korea (KR), Australia (AU), New Zealand (NZ), Hong Kong (HK), UAE (AE).

---

🏪 Included Retail & Supermarket Chains

• Supermarkets: Lidl, Aldi, Walmart, Costco, Carrefour, DMart, Tesco, Target, Sainsbury's, Coles, Woolworths, Esselunga, Mercadona, Rewe, Edeka, Biedronka, Albert Heijn, Delhaize, Jumbo.
• Pharmacies & Healthcare: 24/7 On-Call Duty Pharmacies (Farmacia di Turno, Apotheken-Notdienst, Pharmacie de Garde), Boots, Walgreens, CVS, Apollo Pharmacy, Mercury Drug.
• Convenience & Fuel: 7-Eleven, FamilyMart, Lawson, OXXO, Circle K, Shell, BP, Repsol, Eni Station.

---

📥 Input Parameters

Parameter	Type	Default	Description
countries	Array<string>	[]	2-letter ISO codes (e.g. ["us", "gb", "de", "fr", "it", "at", "es", "nl", "sg", "jp", "in", "th", "vn"]).
year	number	2026	Target calendar year (2025–2030).
categories	Array<string>	[]	Filter categories (supermarkets, pharmacies, petrol, banks, transit, retail, diy).
chains	Array<string>	[]	Specific chain slugs (e.g. ["lidl", "aldi", "dmart", "walmart", "costco", "tesco", "carrefour"]).
holidays	Array<string>	[]	Specific holiday slugs (e.g. ["christmas-day", "independence-day", "ferragosto", "songkran"]).
includeEmergencyServices	boolean	true	Include on-call duty pharmacies and emergency hotlines.
maxItems	number	500	Maximum records to export.

---

📤 Sample Output JSON

{
  "countryCode": "IT",
  "countryName": "Italy",
  "holidayName": "Ferragosto (Assumption of Mary)",
  "holidaySlug": "ferragosto",
  "date": "2026-08-15",
  "year": 2026,
  "isPublicHoliday": true,
  "isBankHoliday": true,
  "chainName": "Esselunga",
  "chainSlug": "esselunga",
  "category": "supermarkets",
  "status": "closed",
  "hours": "Closed",
  "note": "Most hypermarkets closed; select city central stores open 08:00–14:00",
  "officialDomain": "esselunga.it",
  "emergency": false,
  "lastVerified": "2026-08-15",
  "sourceUrl": "https://openonholiday.com/it/is-esselunga-open-on-ferragosto/"
}

---

🔗 Official Links & Data Attribution

• Website: OpenOnHoliday.com
• API Documentation & Feeds: OpenOnHoliday LLM & Agent Manifest