Developers
Free public holiday API
Clean JSON and calendar files for 247 countries and territories, 2026–2028. No key, no sign-up, CORS enabled. Holiday names in English, French, Spanish, Portuguese and Chinese with ?lang=. Please link back to Glassyear where you use it.
Endpoints
GET https://glassyear.com/api/v1/countries.json?lang=frAll country codes and namesGET https://glassyear.com/api/v1/{cc}/{year}.json?lang=esEvery holiday for one country and year — e.g. /api/v1/ht/2027.json?lang=frGET https://glassyear.com/api/v1/next/{cc}.jsonThe next holiday for a country — e.g. /api/v1/next/us.jsonGET https://glassyear.com/ics/{cc}/{year}.icsCalendar file for Google, Apple and Outlook
Country codes are ISO 3166-1 alpha-2, lowercase. lang is one of en, fr, es, pt, zh. Fair use: cache responses; they change rarely. Data is provided as-is, without warranty — see methodology and terms.