ScotlandScotland Public Holidays API

Get the public holidays of Scotland 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.

Scotland is a region of United Kingdom. Its calendar lists only the holidays observed in Scotland, including the ones shared with the rest of United Kingdom. For the whole country, see the United Kingdom public holidays API.

Scotland API details

RegionScotland
Part ofUnited Kingdom
Region code (code parameter)GB-SCT
Short codeSCT
EndpointGET /api/v1/holidays
Output formatsJSON, CSV, XML

How to get Scotland public holidays

Create a free account, copy your API key from the dashboard, and request a date for Scotland. Use code=GB-SCT or country=Scotland.

cURL

curl "https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB-SCT&date=01-01-2025"

JavaScript

const response = await fetch(
  'https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB-SCT&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-SCT", "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 GBSCTHolidays {
    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-SCT&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": "Scotland",
      "country_code": "GB-SCT"
    }
  ]
}

See the full API documentation for date formats, date ranges and every parameter.