{
  "schemaVersion": 1,
  "datasetId": "zanfam-uk-bank-holidays",
  "source": {
    "schemaVersion": 1,
    "sourceUrl": "https://www.gov.uk/bank-holidays.json",
    "sourceType": "official-government-json-feed",
    "snapshotDate": "2026-10-04",
    "sha256": "538b3482c28b85ecd2db606a0d5ae6ad17248900b6498700ce0a48d26a3ecde6",
    "bytes": 22207,
    "license": "OGL-UK-3.0",
    "licenseUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
    "termsReviewedOn": "2026-10-04",
    "termsUrl": "https://www.gov.uk/help/terms-conditions"
  },
  "generator": "scripts/import_uk_holidays.py",
  "reproduceCommand": "python3 scripts/import_uk_holidays.py --check",
  "refreshCommand": "python3 scripts/import_uk_holidays.py --refresh --snapshot-date YYYY-MM-DD --curl",
  "refreshPolicy": "Manual reviewed refresh only. Inspect feed/term changes and re-run tests before deployment.",
  "networkDuringNormalBuild": false,
  "upstreamRuntimeRequests": false,
  "runtimeDelivery": "Small bundled JSON requested from the same site; no upstream request at runtime.",
  "attributionPath": "/data/OGL-ATTRIBUTION.txt",
  "output": {
    "path": "/data/uk-bank-holidays.json",
    "sha256": "1d04a1889b9195bf0c9536efa4f05c798d80153546bc8a58217f3fd026881fa9",
    "bytes": 23300
  },
  "coverage": {
    "start": "2019-01-01",
    "end": "2028-12-26",
    "years": [
      2019,
      2020,
      2021,
      2022,
      2023,
      2024,
      2025,
      2026,
      2027,
      2028
    ],
    "eventCount": 280
  },
  "divisions": [
    {
      "id": "england-and-wales",
      "label": "England and Wales",
      "start": "2019-01-01",
      "end": "2028-12-26",
      "years": [
        2019,
        2020,
        2021,
        2022,
        2023,
        2024,
        2025,
        2026,
        2027,
        2028
      ],
      "eventCount": 83,
      "sourceEventCount": 83,
      "exactDuplicatesRemoved": 0
    },
    {
      "id": "scotland",
      "label": "Scotland",
      "start": "2019-01-01",
      "end": "2028-12-26",
      "years": [
        2019,
        2020,
        2021,
        2022,
        2023,
        2024,
        2025,
        2026,
        2027,
        2028
      ],
      "eventCount": 94,
      "sourceEventCount": 94,
      "exactDuplicatesRemoved": 0
    },
    {
      "id": "northern-ireland",
      "label": "Northern Ireland",
      "start": "2019-01-01",
      "end": "2028-12-26",
      "years": [
        2019,
        2020,
        2021,
        2022,
        2023,
        2024,
        2025,
        2026,
        2027,
        2028
      ],
      "eventCount": 103,
      "sourceEventCount": 103,
      "exactDuplicatesRemoved": 0
    }
  ],
  "transformations": [
    "Validate exactly three official division IDs and matching division fields.",
    "Validate ISO date-only values using the Gregorian calendar; preserve all returned years.",
    "Preserve official titles, notes and bunting values; compute no additional holiday dates.",
    "Remove exact duplicates within each division; reject same-date/title conflicting duplicates.",
    "Retain distinct events on the same date and holidays shared across divisions.",
    "Sort each division by date and title for deterministic output."
  ],
  "limitations": [
    "Snapshot, not a live government connection; dates and publication horizon may change.",
    "A bank holiday does not establish a school closure, employee entitlement or household schedule.",
    "Official notes identify substitute days where provided; do not infer or invent unlisted observances.",
    "No official endorsement; source and licence attribution must remain visible."
  ]
}