Open Holiday Data

How the dates are produced

Wherever a country has a statutory rule, the date is computed — Easter with the Gregorian algorithm, "nth weekday of the month" rules, and each country's weekend-substitution law (US federal: Saturday → Friday before, Sunday → Monday after; UK: next working day, Christmas and Boxing Day as a pair; New Zealand: Mondayisation; South Africa: Sunday → Monday). Only two holidays are table-driven because governments set them each year: Matariki (New Zealand) and Diwali (India), filled in through 2030.

Every list is checked against the official government publication for that country. National holidays only — state, provincial and regional days are excluded on purpose, because a national list is the only one that is correct for everyone.

Format

GET https://calendarprint.co/data/holidays/gb-2026.json

{
  "country": "GB",
  "name": "United Kingdom (England & Wales)",
  "year": 2026,
  "source": "https://calendarprint.co/open-data/",
  "generated": "2026-10-13",
  "holidays": [
    { "date": "2026-01-01", "name": "New Year's Day", "shortName": "New Year", "type": "bank" },
    { "date": "2026-04-03", "name": "Good Friday",     "shortName": "Good Friday", "type": "bank" },
    ...
  ]
}

type is public, bank or observance. Observed/substitute days carry "(observed)" in the name. An index of every file is at /data/holidays/index.json.