Tools/holidays/next

holidays/next

The next upcoming public holidays for a country, in date order.

Free / no pricing configured

What it does

Returns the next public holidays for a country starting from a date (today by default), in chronological order. Crosses the year boundary as needed.

Primary use cases

  • Answering "when is the next holiday" for a country.
  • Planning ahead for closures or campaigns around upcoming holidays.

Good to know

Country codes are ISO 3166-1 alpha-2. count defaults to 5 (max 50). Pass from_date to look ahead from a specific day. Computed locally.

Parameters

countintegeroptional

How many upcoming holidays to return. Defaults to 5.

countrystringrequired

ISO 3166-1 alpha-2 country code (e.g. US, FR, GB).

languagestringoptional

Optional language code for localized holiday names.

from_datestringoptional

Look ahead from this date, YYYY-MM-DD. Defaults to today.

subdivisionstringoptional

Optional ISO 3166-2 subdivision code (e.g. CA, NSW).

holidays/next — Faro