When is the next bank holiday?

Free UK bank holiday API

Simple JSON for UK and Irish bank holidays. No API key, CORS enabled, cached at the edge. Please credit us with a link if you use it publicly.

Next bank holiday

GET https://whenisthenextbankholiday.com/api/v1/next.json
GET https://whenisthenextbankholiday.com/api/v1/next.json?region=scotland
{
  "next": {
    "scotland": { "date": "2026-11-30", "title": "St Andrew's Day", "type": "st-andrews-day",
                  "substitute": false, "provisional": false, "days_until": 75 }
  }
}

All dates for a nation

GET https://whenisthenextbankholiday.com/api/v1/england-and-wales.json
GET https://whenisthenextbankholiday.com/api/v1/scotland.json
GET https://whenisthenextbankholiday.com/api/v1/northern-ireland.json
GET https://whenisthenextbankholiday.com/api/v1/ireland.json

Everything

GET https://whenisthenextbankholiday.com/api/v1/bank-holidays.json

Fields

  • date – ISO date (YYYY-MM-DD)
  • title – holiday name
  • type – a stable key such as easter-monday, or one-off
  • substitute – true if moved from a weekend
  • provisional – true if calculated from the usual rules because GOV.UK hasn't published it yet

Fair use

Responses are cached for an hour, so there's no need to call the API more than a few times a day. UK data is derived from GOV.UK under the Open Government Licence v3.0.