Free holiday API

Every country and year as static JSON. CORS enabled, no API key, no rate limit — please cache responses and attribute HolidayKit.

Endpoints

GET https://holidaykit.pages.dev/api/v1/countries.json
GET https://holidaykit.pages.dev/api/v1/holidays/{country}/{year}.json
GET https://holidaykit.pages.dev/api/v1/holidays/AL/2026.json   (example)

Example response

{
  "country": "AL",
  "name": "Albania",
  "year": 2026,
  "holidays": [
    {"date": "2026-01-01", "name": "New Year's Day", "types": ["Public", "Bank"], "global": true, "counties": []}
  ]
}

Notes

Country codes are ISO 3166-1 alpha-2: AL, AD, AR, AM, AU, AT, AZ, BH, BD, BY, BE, BR, BG, CA, CL, CN, CO, CR, HR, CY, CZ, DK, EC, EG, …
Rows include types (Public / Bank / School), global and counties (regional scope).
Data is rebuilt when sources change; see generatedAt in countries.json.
Commercial use under the free tier requires a link back to HolidayKit.

Embed instead

Use the one-line widget if you just want a calendar on a page.

← Back to all countries