Public Holidays API
Public holidays for 204 countries and territories, served from our own database — 23,786 holidays covering 2020 through 2028, sourced from the MIT-licensed Nager.Date project. Each holiday carries its English and local name, nationwide-vs-regional scope (with ISO subdivision codes: Lincoln's Birthday lists US-CA, US-NY...), fixed-date flag and types (Public, Bank, Observance...). Get a country's year (US 2026 correctly shows Independence Day observed on Friday July 3), ask if a given date is a holiday (/holidays/today — 178 countries celebrate December 25), pull the next upcoming holidays for any country, or request computed long weekends (US 2026 has 8 three-day-plus breaks, listed with dates and the anchor holiday). The original /v1/{year}/{code} route still works unchanged, so existing integrations keep running — but responses now come from D1 in milliseconds with multi-year history instead of a third-party proxy call. Scheduling, HR and payroll tools, delivery-date calculators, booking systems and marketing calendars.
Also Available On
Available Endpoints
Request Parameters
API URL
Please subscribe to see the API URL
Headers
Path Parameters
Please subscribe to see the actual API URL
import axios from 'axios';
const url = '{API_URL}';
const { data } = await axios.get(url, {
headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});