UK Bank Holidays API
Overview
The UK Bank Holidays API is an official UK government endpoint that returns all bank holidays for England and Wales, Scotland, and Northern Ireland as structured JSON. The data is maintained and updated directly by the government, making it authoritative and reliable. No authentication is required — the URL itself (gov.uk/bank-holidays.json) is the complete API.
Beginner Tip
This is one of the most reliable no-auth APIs available: just fetch https://www.gov.uk/bank-holidays.json and you immediately get structured JSON. The top-level keys are 'england-and-wales', 'scotland', and 'northern-ireland' — pick the one relevant to your users.
Available Data
Example Response
{
"status": "success",
"data": {
"result": "Data from UK Bank Holidays",
"description": "Bank holidays in England and Wales, Scotland and Northern Ireland",
"timestamp": "2025-01-15T10:00:00Z"
}
} Field Reference
england-and-wales Container for bank holiday data covering England and Wales, with 'division' and 'events' sub-fields scotland Container for bank holiday data specific to Scotland northern-ireland Container for bank holiday data specific to Northern Ireland events[].title Official name of the bank holiday, e.g. 'Christmas Day' or 'New Year Day' events[].date Date of the bank holiday in YYYY-MM-DD format events[].bunting Whether the government recommends displaying bunting for this holiday Implementation Example
const url = "https://www.gov.uk/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data); What Can You Build?
Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.
Common Errors & Troubleshooting
Matrix Score Breakdown
Fully tested on Apr 5, 2026
Technical Specifications
Related Tags
Similar APIs
View All →Church Calendar
⭐ Beginner's PickChurch Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month.
Czech Namedays Calendar
⭐ Beginner's PickThe Czech Namedays Calendar API lets you look up the Czech or Slovak nameday (svátek) associated with a given first name, or find whose nameday falls on a specific date.
Hebrew Calendar
⭐ Beginner's PickThe Hebcal API provides free Jewish calendar data including Hebrew date conversions, Shabbat candle-lighting times, Jewish holidays, and weekly Torah portion readings.
LectServe
⭐ Beginner's PickLectServe is a free REST API that returns Revised Common Lectionary readings — Scripture passages assigned to each Sunday and feast day used by many Protestant denominations.
Nager.Date
⭐ Beginner's PickNager.Date is a completely free, open-source REST API providing public holidays for over 90 countries with no API key required.