Pass a country code and get that year's holidays: date, name, type, and whether the day off moved (substitute). Years carry cultural observances like Halloween, Mother's Day, and White Day next to the official days, told apart by type. Add ?year= for another year, or ask about one date at /holiday/{country}/{date} and read holiday or null.
France, Austria, and Slovenia keep their source-language names. Japan, Hong Kong, and Taiwan pair the official English name with the native form in local_name. GB rows carry a regions tag when only part of the UK takes the day.
Try it
$ curl "https://api.parseapi.com/holiday/US" \ -H "X-API-Key: YOUR_API_KEY" // 200 · ~16ms · USA { "country": "US", "year": 2026, "holidays": [ { "date": "2026-01-01", "name": "New Year's Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-01-19", "name": "Birthday of Martin Luther King, Jr.", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-02-14", "name": "Valentine's Day", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-02-16", "name": "Washington's Birthday", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-03-17", "name": "St. Patrick's Day", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-04-03", "name": "Good Friday", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-04-05", "name": "Easter Sunday", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-05-05", "name": "Cinco de Mayo", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-05-10", "name": "Mother's Day", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-05-25", "name": "Memorial Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-06-19", "name": "Juneteenth National Independence Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-06-21", "name": "Father's Day", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-07-03", "name": "Independence Day", "local_name": null, "type": "public", "regions": null, "substitute": true }, { "date": "2026-09-07", "name": "Labor Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-10-12", "name": "Columbus Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-10-31", "name": "Halloween", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-11-11", "name": "Veterans Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-11-26", "name": "Thanksgiving Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-11-27", "name": "Black Friday", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-12-24", "name": "Christmas Eve", "local_name": null, "type": "observance", "regions": null, "substitute": false }, { "date": "2026-12-25", "name": "Christmas Day", "local_name": null, "type": "public", "regions": null, "substitute": false }, { "date": "2026-12-31", "name": "New Year's Eve", "local_name": null, "type": "observance", "regions": null, "substitute": false } ] }
Response fields
SPEED
Median time for a core lookup to reach a real city, first byte back, measured live from 16 cities.
US
16ms
EU
19ms
APAC
45ms
LatAm
20ms
ME
127ms
Nine countries, each from its official national source.