Public Holidays by Country and Year - Dates and Local Names
Pricing
Pay per usage
Public Holidays by Country and Year - Dates and Local Names
Every public holiday for a country and year as flat rows - date, local name, English name, scope and type. Free public API, no key.
Pricing
Pay per usage
Rating
0.0
(0)
Developer
alaudin burki
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 hours ago
Last modified
Categories
Share
Public Holidays by Country and Year — Dates and Local Names
Every public holiday for a country and year as flat rows — date, local name, English name, regional scope and type. Free public API, no key.
What you get
date, name, localName, countryCode, global, counties, types, launchYear.
Sample output
{ "date": "2026-01-01", "name": "New Year's Day", "localName": "New Year's Day","countryCode": "GB", "global": false, "counties": ["GB-ENG", "GB-SCT"] }
Limitations
global: falsemeans the holiday is regional — readcountiesbefore treating it as nationwide.- Substitute and one-off holidays are included by the source and are not distinguished here.
- Covers several dozen countries, not every country.
- Dates are the official published dates; a country can amend them after publication.
Inputs
| Input | Type | Default | What it does |
|---|---|---|---|
year | integer | — | Four-digit year, e.g |
country | string | — | Two-letter ISO code, e.g |
Stops after 200 rows or 1 requests, whichever comes first — raise
maxItems and maxPages for more. Requests are paced ? ms apart.
The dataset's SUMMARY records truncated and stopReason, so a run that hit a cap says so
rather than looking like a source that had nothing more.
Pricing
Pay per result.
Fields
| Field | Type | What it holds |
|---|---|---|
date | string | ISO 8601 date associated with this record. |
name | string | Display name as the source writes it. |
localName | string | Name in the local language. Often differs from the English name returned alongside it. |
countryCode | string | Two-letter ISO 3166-1 country code. |
global | boolean | Whether the source marks this as applying nationally rather than to a region. |
counties | number | Counties or regions the item applies to, where it is not national. |
types | string | Type labels the source assigns, joined into one string. |
launchYear | number | Year of the launch the record refers to. |