UK Bank Holidays SDKs & Libraries: Integration Guide (2026)

SDKs overview

The UK Bank Holidays API, provided by the UK government, offers a public JSON endpoint for retrieving official bank holiday dates across England and Wales, Scotland, and Northern Ireland. While there are no officially published Software Development Kits (SDKs) in the conventional sense, the API's simplicity allows for direct integration using standard HTTP client libraries available in most programming languages. The data is structured to differentiate holidays by region and year, providing specific event details such as title and date UK Bank Holidays JSON endpoint. This direct access model means developers typically interact with the API using general-purpose libraries rather than dedicated, pre-built SDKs.

This page outlines common approaches for consuming the UK Bank Holidays data using popular programming languages. It details how to set up basic HTTP requests and parse the JSON responses, demonstrating practical integration methods for developers. The goal is to facilitate straightforward access to the holiday data for applications requiring accurate UK public holiday schedules.

Official SDKs by language

As the UK Bank Holidays API operates through a single, publicly accessible JSON endpoint without authentication, there are no official, branded SDKs provided by the UK government. The API is designed for direct consumption via standard HTTP requests. Developers typically use their language's native HTTP client libraries to fetch and parse the JSON data. The API's structure provides data organized by region and year, allowing for precise filtering and display of holiday information for specific parts of the UK UK government bank holidays data structure.

The table below illustrates common patterns for interacting with the UK Bank Holidays API using various programming languages and their respective HTTP libraries. While not 'official SDKs,' these represent the most common and direct methods of integration.

Installation

Since the UK Bank Holidays API does not provide dedicated SDKs, installation typically involves adding a standard HTTP client library to your project. These libraries are generally available through package managers commonly used in each programming ecosystem.

Python

For Python, the requests library is a common choice for making HTTP requests. Install it using pip:

pip install requests

JavaScript (Node.js)

In Node.js environments, axios is a popular promise-based HTTP client. Install it via npm:

npm install axios

Alternatively, the native fetch API is available in modern browsers and Node.js v18+ without any installation.

Java

For Java 11 and later, the built-in java.net.http.HttpClient requires no external installation. Older Java versions or projects preferring a third-party library might use OkHttp. If using Maven, add the following dependency to your pom.xml:

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version>
</dependency>

For Gradle, add to build.gradle:

implementation 'com.squareup.okhttp3:okhttp:4.12.0'

C# (.NET)

The HttpClient class is part of the .NET framework and requires no separate installation. It is available by default in C# projects.

Ruby

Ruby's standard library includes Net::HTTP. For a more convenient API, httparty is a widely used gem. Install it via Bundler:

gem install httparty

Then add to your Gemfile:

gem 'httparty'

Quickstart example

The following examples demonstrate how to fetch and parse UK Bank Holidays data using common HTTP client libraries. The API endpoint provides a JSON object containing different regions (e.g., england-and-wales, scotland, northern-ireland), each with an array of holiday events UK Bank Holidays data structure.

Python example (using requests)

import requests

def get_uk_bank_holidays():
    url = "https://www.gov.uk/bank-holidays.json"
    try:
        response = requests.get(url)
        response.raise_for_status()  # Raise an exception for HTTP errors
        data = response.json()
        
        # Example: Print bank holidays for England and Wales
        england_wales_holidays = data.get('england-and-wales', {}).get('events', [])
        print("\nBank Holidays for England and Wales:")
        for holiday in england_wales_holidays:
            print(f"  {holiday['date']}: {holiday['title']}")
            
        # Example: Print bank holidays for Scotland
        scotland_holidays = data.get('scotland', {}).get('events', [])
        print("\nBank Holidays for Scotland:")
        for holiday in scotland_holidays:
            print(f"  {holiday['date']}: {holiday['title']}")

    except requests.exceptions.RequestException as e:
        print(f"Error fetching data: {e}")
    except ValueError as e:
        print(f"Error parsing JSON: {e}")

if __name__ == "__main__":
    get_uk_bank_holidays()

JavaScript example (Node.js using axios)

const axios = require('axios');

async function getUkBankHolidays() {
  const url = 'https://www.gov.uk/bank-holidays.json';
  try {
    const response = await axios.get(url);
    const data = response.data;

    // Example: Log bank holidays for England and Wales
    const englandWalesHolidays = data['england-and-wales']?.events || [];
    console.log('\nBank Holidays for England and Wales:');
    englandWalesHolidays.forEach(holiday => {
      console.log(`  ${holiday.date}: ${holiday.title}`);
    });
    
    // Example: Log bank holidays for Northern Ireland
    const northernIrelandHolidays = data['northern-ireland']?.events || [];
    console.log('\nBank Holidays for Northern Ireland:');
    northernIrelandHolidays.forEach(holiday => {
      console.log(`  ${holiday.date}: ${holiday.title}`);
    });

  } catch (error) {
    console.error('Error fetching data:', error.message);
  }
}

getUkBankHolidays();

Java example (using HttpClient - Java 11+)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

public class UkBankHolidays {

    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://www.gov.uk/bank-holidays.json"))
                .build();

        try {
            HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
            
            if (response.statusCode() == 200) {
                ObjectMapper mapper = new ObjectMapper();
                JsonNode root = mapper.readTree(response.body());

                // Print bank holidays for England and Wales
                JsonNode englandWales = root.path("england-and-wales").path("events");
                System.out.println("\nBank Holidays for England and Wales:");
                if (englandWales.isArray()) {
                    for (JsonNode holiday : englandWales) {
                        System.out.println("  " + holiday.path("date").asText() + ": " + holiday.path("title").asText());
                    }
                }

                // Print bank holidays for Scotland
                JsonNode scotland = root.path("scotland").path("events");
                System.out.println("\nBank Holidays for Scotland:");
                if (scotland.isArray()) {
                    for (JsonNode holiday : scotland) {
                        System.out.println("  " + holiday.path("date").asText() + ": " + holiday.path("title").asText());
                    }
                }

            } else {
                System.err.println("Failed to fetch data. Status code: " + response.statusCode());
            }

        } catch (Exception e) {
            System.err.println("Error: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Note: For the Java example, you'll need a JSON parsing library like Jackson. Add the following Maven dependency:

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- Use a recent version -->
</dependency>

Community libraries

Given the straightforward nature of the UK Bank Holidays API—a simple HTTP GET request to a JSON endpoint—the community has not developed a large ecosystem of dedicated SDKs. Instead, developers typically rely on general-purpose HTTP client libraries and JSON parsers, as demonstrated in the quickstart examples. This approach aligns with best practices for consuming RESTful APIs, as outlined by resources such as the W3C's guidance on REST principles and the IETF's HTTP semantic specifications.

While specific 'community SDKs' for this particular API are rare, developers often create helper functions or small utilities within their projects to encapsulate the logic for fetching and parsing the bank holiday data. These internal utilities serve a similar purpose to a lightweight SDK, abstracting the raw HTTP requests and providing a more convenient interface for application-specific needs. Searching package repositories like PyPI (for Python), npm (for JavaScript), or Maven Central (for Java) might reveal small, domain-specific packages created by individual developers, but these generally wrap the same underlying HTTP request logic.

The primary advantage of this API's design is its minimal barrier to entry, allowing developers to integrate it directly without needing to learn specific SDK-bound patterns. This flexibility ensures compatibility across a wide range of environments and technology stacks, leveraging existing, well-understood web technologies.