United Kingdom Public Holidays API
Get the public holidays of United Kingdom with one HTTP request. HolidaysMap covers 195+ countries from 1985 to 2030+, returns JSON, CSV or XML, and starts free with paid plans from just €3/month.
United Kingdom API details
| Country | United Kingdom |
|---|---|
Country code (code parameter) | GB |
| ISO 3166-1 alpha-3 | GBR |
| Endpoint | GET /api/v1/holidays |
| Output formats | JSON, CSV, XML |
How to get United Kingdom public holidays
Create a free account, copy your API key from the dashboard, and request a date for United Kingdom. Use code=GB or country=United Kingdom.
cURL
curl "https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB&date=01-01-2025"JavaScript
const response = await fetch(
'https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB&date=01-01-2025',
);
const { count, holidays } = await response.json();Python
import requests
response = requests.get(
"https://holidaysmap.com/api/v1/holidays",
params={"key": "YOUR_API_KEY", "code": "GB", "date": "01-01-2025"},
)
holidays = response.json()["holidays"]Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class GBHolidays {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB&date=01-01-2025"))
.GET()
.build();
HttpResponse<String> response =
client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}Response format
{
"count": 1,
"holidays": [
{
"name": "Holiday name",
"date": "01-01-2025",
"is_public": true,
"country": "United Kingdom",
"country_code": "GB"
}
]
}See the full API documentation for date formats, date ranges and every parameter.
Looking for dates instead of API details? See the United Kingdom public holidays calendar for 2026 and 2027.
United Kingdom regional holidays API
Some holidays in United Kingdom apply only in part of the country. The code=GB calendar includes all of them. To get the holidays of one region only, use its regional code: