Northern Ireland Public Holidays API
Get the public holidays of Northern Ireland 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.
Northern Ireland is a region of United Kingdom. Its calendar lists only the holidays observed in Northern Ireland, including the ones shared with the rest of United Kingdom. For the whole country, see the United Kingdom public holidays API.
Northern Ireland API details
| Region | Northern Ireland |
|---|---|
| Part of | United Kingdom |
Region code (code parameter) | GB-NIR |
| Short code | NIR |
| Endpoint | GET /api/v1/holidays |
| Output formats | JSON, CSV, XML |
How to get Northern Ireland public holidays
Create a free account, copy your API key from the dashboard, and request a date for Northern Ireland. Use code=GB-NIR or country=Northern Ireland.
cURL
curl "https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB-NIR&date=01-01-2025"JavaScript
const response = await fetch(
'https://holidaysmap.com/api/v1/holidays?key=YOUR_API_KEY&code=GB-NIR&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-NIR", "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 GBNIRHolidays {
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-NIR&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": "Northern Ireland",
"country_code": "GB-NIR"
}
]
}See the full API documentation for date formats, date ranges and every parameter.