Official public holidays for any country and year (100+ countries)

Full list of official public holidays for one country and year, from the Nager.Date registry (100+ countries, legally accurate dates). Query: ?country=FR (ISO 3166-1 alpha-2, required) &year=2026 (1975-2077, defaults to current year). Returns date, English + local name, nationwide flag, regional counties and holiday types per entry. Cached 24h.

get/v1/world/holidays

Request

  • Base URL: https://data.greeneris.io (the document declares no server; this is the origin it was published from)
  • URL: https://data.greeneris.io/v1/world/holidays
  • Auth: none declared

Query parameters

countrystring required

ISO 3166-1 alpha-2 country code, e.g. FR

yearinteger

Year between 1975 and 2077 (default: current year)

Response

Successful response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.