DEVELOPER API

Holiday data for 249 countries, in 11 languages

Public holidays 2024–2028 with substitute-day and tentative-date flags, verified against official government sources. REST API and iCal feeds.

GET /v1/countries GET /v1/holidays GET /v1/holidays/next

Try it

curl "https://api.the-world-holidays.com/v1/holidays?country=JP&year=2026&lang=en"

{
  "count": 18,
  "results": [
    {"date": "2026-01-01", "country": "JP", "name": "New Year's Day",
     "is_substitute": false, "is_tentative": false, ...}
  ]
}

Free while in beta · rate limited per IP · attribution appreciated. Parameters: country (ISO2, comma-separated), year, from/to, lang (ja/en/ko/zh/es/fr/de/pt/th/vi/id).