UK Bank Holidays

Overview

The UK Government publishes all UK bank holidays — England & Wales, Scotland, and Northern Ireland — as a single JSON file. Keyless, free, and authoritative (verified live): one URL, no registration, always current.

Quick Start

All bank holidays (verified live):

curl "https://www.gov.uk/bank-holidays.json"

{
  "england-and-wales": {
    "division": "england-and-wales",
    "events": [
      { "title": "New Year's Day", "date": "2026-01-01", "notes": "", "bunting": true }
    ]
  },
  "scotland": { "events": [] },
  "northern-ireland": { "events": [] }
}

Authentication

None — keyless.

Rate Limits & Notes

• Free, public government data — no key, no documented hard limit.
• Three divisions: england-and-wales, scotland, northern-ireland — each with an events array.
• Events have title, date (ISO), notes, and bunting (flag display flag).
• The file is updated well in advance for upcoming years — ideal for holiday calendars.

FAQ

Is the UK bank holidays API free? Yes — free, keyless, public government data.

Does it include Scotland and NI? Yes — all three divisions in one file.

How current is it? Maintained by the UK Government — upcoming years are published in advance.