# Nager.Date

> Look up public holidays for over 200 countries from a workflow. List a country's holidays for a year or for a date range, get the next one coming up, check whether a particular date, or today, is a holiday, count the working days between two dates with weekends and holidays taken out, find the long weekends a year holds, and see every country's holidays for the week ahead. Holidays that apply only in a state or region are handled properly, so choosing California or Bavaria gives the calendar someone there really keeps. Every action reads: nothing here changes anything. No account or API key required.

App · Calendars · 13 actions. Web page: https://docs.lodol.com/docs/integrations/nager-date

## Actions

### Check whether a date is a holiday

Check one date in one country and get three plain answers: is it a holiday, is it a weekend day, is it a working day. Use it to gate a workflow on whether an office is open, or to decide whether to send something today. Only Public holidays count as a day off unless you say otherwise, and anything else marked on the date is reported separately rather than silently dropped.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- Date to check (`check_on`, date, required): The date to check. It has to fall in a year the API serves, which is last year through five years ahead.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Count these as days off (`holiday_types`, list): Which holiday types count as a day off here. Public alone by default, because that is what closes an office: counting Observance entries too would mark Valentine's Day as a non-working day. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off). Default: `["Public"]`.
- Weekend days (`weekend_days`, list): Which days of the week are not worked. Saturday and Sunday by default. Set it to Friday and Saturday for the Gulf states, or to Friday alone where that is the rest day, otherwise the count is out by a day or two every week. One or more of: `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, `Saturday`, `Sunday`. Default: `["Saturday", "Sunday"]`.

**Outputs**

- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `date` (text): The date that was checked
- `holiday_names` (list): Just their names
- `holiday_types` (list): The types counted as a day off
- `holidays` (list): The holidays that made it a holiday
- `is_holiday` (true/false): True when a holiday of the chosen types applies
- `is_weekend` (true/false): True when it falls on one of the weekend days
- `is_working_day` (true/false): True when it is neither a weekend day nor a holiday
- `other_holidays` (list): Holidays on the same date that the filters left out, such as an Observance or another region's day
- `subdivision` (text): The subdivision filter applied, or null
- `weekday` (text): The day of the week it falls on
- `weekend_days` (list): The days treated as the weekend

**Example output**

```json
{
  "country_code": "US",
  "country_name": "United States",
  "date": "2026-12-25",
  "holiday_names": [
    "Christmas Day"
  ],
  "holiday_types": [
    "Public"
  ],
  "holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-12-25",
      "days_until": 120,
      "holiday_types": [
        "Public",
        "Bank"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Christmas Day",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Friday"
    }
  ],
  "is_holiday": true,
  "is_weekend": false,
  "is_working_day": false,
  "other_holidays": [],
  "subdivision": null,
  "weekday": "Friday",
  "weekend_days": [
    "Saturday",
    "Sunday"
  ]
}
```

### Check whether today is a holiday

Ask Nager.Date whether today is a public holiday in a country or one of its states, and get back the holiday's name with the answer. Pick the UTC offset of the place you mean so 'today' is their today rather than UTC's. Built for a daily scheduled workflow that should skip a run on a holiday.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Time zone offset (`utc_offset`, text): The UTC offset of the place you are asking about. Defaults to UTC. It decides which day counts as today, which matters either side of midnight. One of: `-12` (UTC-12:00), `-11` (UTC-11:00), `-10` (UTC-10:00 (Hawaii)), `-9` (UTC-09:00 (Alaska)), `-8` (UTC-08:00 (US Pacific)), `-7` (UTC-07:00 (US Mountain)), `-6` (UTC-06:00 (US Central)), `-5` (UTC-05:00 (US Eastern)), `-4` (UTC-04:00), `-3` (UTC-03:00 (Sao Paulo)), and 15 more. Default: `0`.

**Outputs**

- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `date` (text): The local date the answer is about
- `holiday_names` (list): Just their names
- `holidays` (list): The public holidays falling on that date
- `is_holiday` (true/false): The API's own answer for today
- `iso_code` (text): The code the endpoint was asked about
- `other_holidays` (list): Anything else marked on that date, such as an Observance
- `subdivision` (text): The subdivision asked about, or null
- `utc_offset` (number): The UTC offset the local date was taken at
- `weekday` (text): The day of the week

**Example output**

```json
{
  "country_code": "US",
  "country_name": "United States",
  "date": "2026-02-12",
  "holiday_names": [],
  "holidays": [],
  "is_holiday": false,
  "iso_code": "US-CA",
  "other_holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-02-12",
      "days_until": -196,
      "holiday_types": [
        "Observance"
      ],
      "is_public": false,
      "local_name": null,
      "name": "Lincoln's Birthday",
      "national": false,
      "subdivision_codes": [
        "US-CA",
        "US-CT",
        "US-IL",
        "US-IN",
        "US-KY"
      ],
      "weekday": "Thursday"
    }
  ],
  "subdivision": "US-CA",
  "utc_offset": -8,
  "weekday": "Thursday"
}
```

### Count working days

Count the working days between two dates, with weekends and public holidays taken out. Use it for a delivery date, an SLA window, a payroll period or a project estimate. It also hands back which holidays cost a working day and which fell on a weekend anyway, and the weekend itself is a setting, so a Friday and Saturday week counts correctly.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- From date (`start_date`, date, required): The first day of the range, counted in.
- To date (`end_date`, date, required): The last day of the range, counted in. It must be on or after the start date, and the range can cover at most seven years.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Count these as days off (`holiday_types`, list): Which holiday types count as a day off here. Public alone by default, because that is what closes an office: counting Observance entries too would mark Valentine's Day as a non-working day. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off). Default: `["Public"]`.
- Weekend days (`weekend_days`, list): Which days of the week are not worked. Saturday and Sunday by default. Set it to Friday and Saturday for the Gulf states, or to Friday alone where that is the rest day, otherwise the count is out by a day or two every week. One or more of: `Monday`, `Tuesday`, `Wednesday`, `Thursday`, `Friday`, `Saturday`, `Sunday`. Default: `["Saturday", "Sunday"]`.

**Outputs**

- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `end_date` (text): The last day of the range
- `holiday_dates` (list): Just those dates
- `holiday_days_off` (number): Working days lost to a holiday
- `holiday_types` (list): The types counted as a day off
- `holidays` (list): The holidays that landed on a working day
- `holidays_on_weekends` (list): Holidays that fell on a weekend day, so cost nobody a working day
- `start_date` (text): The first day of the range
- `subdivision` (text): The subdivision filter applied, or null
- `total_days` (number): Every day in the range, both ends counted
- `weekend_days` (list): The days treated as the weekend
- `weekend_days_count` (number): How many fell on a weekend day
- `working_days` (number): Days that are neither weekend nor holiday

**Example output**

```json
{
  "country_code": "US",
  "country_name": "United States",
  "end_date": "2026-12-31",
  "holiday_dates": [
    "2026-12-25"
  ],
  "holiday_days_off": 1,
  "holiday_types": [
    "Public"
  ],
  "holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-12-25",
      "days_until": 120,
      "holiday_types": [
        "Public",
        "Bank"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Christmas Day",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Friday"
    }
  ],
  "holidays_on_weekends": [],
  "start_date": "2026-12-01",
  "subdivision": null,
  "total_days": 31,
  "weekend_days": [
    "Saturday",
    "Sunday"
  ],
  "weekend_days_count": 8,
  "working_days": 22
}
```

### Get a country

Get one country's names and land borders: the name in common use, the official one, the name in its own language, the region it sits in, and every country it shares a border with. This is the one action that also answers for a country with no holiday calendar, so it can name a code the holiday actions turn down.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.

**Outputs**

- `country` (object)

**Example output**

```json
{
  "country": {
    "border_count": 2,
    "border_country_codes": [
      "AT",
      "PL"
    ],
    "borders": [
      {
        "common_name": "Austria",
        "country_code": "AT",
        "native_name": "Osterreich",
        "official_name": "Republic of Austria",
        "region": "Europe"
      },
      {
        "common_name": "Poland",
        "country_code": "PL",
        "native_name": "Polska",
        "official_name": "Republic of Poland",
        "region": "Europe"
      }
    ],
    "common_name": "Germany",
    "country_code": "DE",
    "native_name": "Deutschland",
    "official_name": "Federal Republic of Germany",
    "region": "Europe"
  }
}
```

### Get the API version

Get the Nager.Date build serving the API, and the range of years the holiday endpoints cover right now. Holiday data is corrected and extended in new builds, so this is how a workflow records which build an answer came from, and a one-step check that the connection works.

**Inputs**: None.

**Outputs**

- `first_supported_year` (number): The earliest year the holiday endpoints serve
- `last_supported_year` (number): The latest year they serve
- `name` (text): The library's name
- `version` (text): The version serving the API

**Example output**

```json
{
  "first_supported_year": 2025,
  "last_supported_year": 2031,
  "name": "Nager.Date",
  "version": "2.44.0"
}
```

### Get the next holiday

Get the single next holiday in a country, returned flat so a later step can read the name, the date and how many days away it is without indexing into a list. Answers 'when is the next day off' in one step. If nothing falls in the next 365 days it returns found = false rather than failing.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Holiday types (`holiday_types`, list): Only holidays of these types. A year's list is not only days off: it also carries School, Optional and Observance entries, and an Observance such as Valentine's Day closes nothing. Leave it empty for every type, or pick Public for the days that are actually holidays. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off).
- National holidays only (`national_only`, true/false): Keep only the holidays that apply to the whole country, dropping the ones limited to particular states or regions. Off by default. Default: `false`.

**Outputs**

- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `date` (text): The date, as YYYY-MM-DD
- `days_until` (number): Days from today
- `found` (true/false): False when nothing matches in the window
- `holiday_types` (list): Public, Bank, School, Authorities, Optional or Observance
- `is_public` (true/false): True when Public is one of the types
- `local_name` (text): The local-language name, which is null here
- `name` (text): The holiday's English name
- `national` (true/false): True when it applies to the whole country
- `subdivision` (text): The subdivision filter applied, or null
- `subdivision_codes` (list): Where it applies when it is not national
- `weekday` (text): The day of the week
- `window_days` (number): How far ahead the endpoint looks, in days

**Example output**

```json
{
  "country_code": "US",
  "country_name": "United States",
  "date": "2026-12-25",
  "days_until": 120,
  "found": true,
  "holiday_types": [
    "Public",
    "Bank"
  ],
  "is_public": true,
  "local_name": null,
  "name": "Christmas Day",
  "national": true,
  "subdivision": null,
  "subdivision_codes": [],
  "weekday": "Friday",
  "window_days": 365
}
```

### List a country's regions

List the states, provinces or nations within a country that have holidays of their own, each with the holidays that make it different from the rest. Use it to find the ISO 3166-2 code a region filter wants, or to see where a country's calendar actually varies. A region with no holiday of its own is not listed, because for it the country's own calendar is the whole answer.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- Year (`year`, text): The calendar year to look up. Defaults to this year. The list holds exactly the years the API serves, which is last year through five years ahead; it moves with the calendar, so use the refresh button beside the field if a new year is missing.

**Outputs**

- `count` (number): How many there are
- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `national_holiday_count` (number): How many holidays apply to the whole country
- `subdivision_codes` (list): Just the codes, ready to feed a later step
- `subdivisions` (list): One entry per subdivision with holidays of its own
- `year` (number): The year the codes came from

**Example output**

```json
{
  "count": 2,
  "country_code": "DE",
  "country_name": "Germany",
  "national_holiday_count": 9,
  "subdivision_codes": [
    "DE-BY",
    "DE-SN"
  ],
  "subdivisions": [
    {
      "code": "DE-BY",
      "dates": [
        "2026-01-06",
        "2026-06-04",
        "2026-11-01"
      ],
      "holiday_count": 3,
      "holiday_names": [
        "Epiphany",
        "Corpus Christi",
        "All Saints' Day"
      ]
    },
    {
      "code": "DE-SN",
      "dates": [
        "2026-11-18"
      ],
      "holiday_count": 1,
      "holiday_names": [
        "Repentance and Prayer Day"
      ]
    }
  ],
  "year": 2026
}
```

### List countries

List every country Nager.Date has holiday data for, with its ISO 3166-1 alpha-2 code, sorted by name. This is the same list every country dropdown here is built from, and the way to check whether somewhere is covered before a workflow depends on it. Search it by name or by code.

**Inputs**

- Search for (`search`, text): Only countries whose name or code contains this text. Case and accents are ignored. Leave empty for all of them.
- How many to return (`limit`, number): How many countries to return. Every match is returned unless you set this. From 1 to 1000.

**Outputs**

- `count` (number): How many are returned
- `countries` (list)
- `country_codes` (list): Just the codes, ready to feed a later step
- `matched_count` (number): How many matched a search
- `search` (text): The search that was applied
- `total_count` (number): How many countries in all

**Example output**

```json
{
  "count": 2,
  "countries": [
    {
      "country_code": "DE",
      "name": "Germany"
    },
    {
      "country_code": "US",
      "name": "United States"
    }
  ],
  "country_codes": [
    "DE",
    "US"
  ],
  "matched_count": 2,
  "search": null,
  "total_count": 204
}
```

### List holidays between two dates

List every holiday between two dates, whether or not they fall in the same year. The API serves whole years only, so a range that crosses new year is fetched year by year and trimmed here; a quarter or a sprint is a single step either way. Narrow it to a state or region and to the types you care about.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- From date (`start_date`, date, required): The first day of the range, counted in.
- To date (`end_date`, date, required): The last day of the range, counted in. It must be on or after the start date, and the range can cover at most seven years.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Holiday types (`holiday_types`, list): Only holidays of these types. A year's list is not only days off: it also carries School, Optional and Observance entries, and an Observance such as Valentine's Day closes nothing. Leave it empty for every type, or pick Public for the days that are actually holidays. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off).
- National holidays only (`national_only`, true/false): Keep only the holidays that apply to the whole country, dropping the ones limited to particular states or regions. Off by default. Default: `false`.

**Outputs**

- `count` (number): How many are returned
- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `dates` (list): Just the dates, ready to feed a later step
- `days_in_range` (number): How many days the range covers
- `end_date` (text): The last day of the range
- `holiday_types` (list): The type filter applied, empty when every type is kept
- `holidays` (list)
- `national_only` (true/false): Whether subdivision holidays were dropped
- `start_date` (text): The first day of the range
- `subdivision` (text): The subdivision filter applied, or null
- `total_count` (number): How many fell in the range before filtering
- `years_covered` (list): The years that had to be fetched

**Example output**

```json
{
  "count": 1,
  "country_code": "US",
  "country_name": "United States",
  "dates": [
    "2026-12-25"
  ],
  "days_in_range": 46,
  "end_date": "2027-01-15",
  "holiday_types": [
    "Public"
  ],
  "holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-12-25",
      "days_until": 120,
      "holiday_types": [
        "Public",
        "Bank"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Christmas Day",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Friday"
    }
  ],
  "national_only": false,
  "start_date": "2026-12-01",
  "subdivision": null,
  "total_count": 3,
  "years_covered": [
    2026,
    2027
  ]
}
```

### List holidays for a year

List a country's holidays for a whole calendar year. Narrow to a state or region, to a month, to a name, or to the holiday types you care about, and each holiday comes back with the date, the weekday, whether it applies nationally and which regions it applies in. Choosing a state keeps that state's own holidays alongside the national ones, which is the calendar someone working there actually keeps.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- Year (`year`, text): The calendar year to look up. Defaults to this year. The list holds exactly the years the API serves, which is last year through five years ahead; it moves with the calendar, so use the refresh button beside the field if a new year is missing.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Holiday types (`holiday_types`, list): Only holidays of these types. A year's list is not only days off: it also carries School, Optional and Observance entries, and an Observance such as Valentine's Day closes nothing. Leave it empty for every type, or pick Public for the days that are actually holidays. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off).
- National holidays only (`national_only`, true/false): Keep only the holidays that apply to the whole country, dropping the ones limited to particular states or regions. Off by default. Default: `false`.
- Name contains (`name_contains`, text): Only holidays whose name contains this text. Case and accents are ignored, and the local name is searched as well where the data has one. Use it to answer 'when is Easter Monday next year' without reading the whole list.
- Month (`month`, text): Only holidays in this month. Leave empty for the whole year. One of: `1` (January), `2` (February), `3` (March), `4` (April), `5` (May), `6` (June), `7` (July), `8` (August), `9` (September), `10` (October), `11` (November), `12` (December).

**Outputs**

- `count` (number): How many are returned
- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `dates` (list): Just the dates, ready to feed a later step
- `holiday_types` (list): The type filter applied, empty when every type is kept
- `holidays` (list)
- `month` (number): The month filter applied, or null
- `month_name` (text): That month's name, or null
- `national_only` (true/false): Whether subdivision holidays were dropped
- `subdivision` (text): The subdivision filter applied, or null
- `total_count` (number): How many the year holds before filtering
- `year` (number): The year looked up

**Example output**

```json
{
  "count": 2,
  "country_code": "US",
  "country_name": "United States",
  "dates": [
    "2026-04-03",
    "2026-12-25"
  ],
  "holiday_types": [
    "Public"
  ],
  "holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-04-03",
      "days_until": -146,
      "holiday_types": [
        "Public"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Good Friday",
      "national": false,
      "subdivision_codes": [
        "US-CT",
        "US-DE",
        "US-HI",
        "US-IN",
        "US-KY"
      ],
      "weekday": "Friday"
    },
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-12-25",
      "days_until": 120,
      "holiday_types": [
        "Public",
        "Bank"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Christmas Day",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Friday"
    }
  ],
  "month": null,
  "month_name": null,
  "national_only": false,
  "subdivision": null,
  "total_count": 17,
  "year": 2026
}
```

### List long weekends

List the long weekends a country's holidays make in a year: when each one starts and ends, how many days off it is, and which working days you would have to take off to join it up. Raise the bridge-day budget to find the longer breaks a couple of days of leave would buy. This endpoint reaches fifty years either side of today, further than the rest.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- Year (`year`, text): The calendar year to look up. Defaults to this year. This list reaches fifty years either side of today, because the long-weekend endpoint covers more years than the holiday endpoints do.
- Bridge days you can take (`available_bridge_days`, number): How many working days you are willing to take off to join a holiday to a weekend. One by default; raising it finds longer breaks. From 1 to 100. Default: `1`.

**Outputs**

- `available_bridge_days` (number): The bridge-day budget that was used
- `bridge_day_count` (number): How many bridge days that would take
- `count` (number): How many there are
- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `long_weekends` (list): One entry per long weekend, earliest first
- `total_days_off` (number): Every day off across all of them
- `year` (number): The year looked up

**Example output**

```json
{
  "available_bridge_days": 1,
  "bridge_day_count": 1,
  "count": 2,
  "country_code": "DE",
  "country_name": "Germany",
  "long_weekends": [
    {
      "bridge_day_count": 1,
      "bridge_days": [
        "2026-01-02"
      ],
      "day_count": 4,
      "end_date": "2026-01-04",
      "needs_bridge_day": true,
      "start_date": "2026-01-01"
    },
    {
      "bridge_day_count": 0,
      "bridge_days": [],
      "day_count": 4,
      "end_date": "2026-04-06",
      "needs_bridge_day": false,
      "start_date": "2026-04-03"
    }
  ],
  "total_days_off": 8,
  "year": 2026
}
```

### List upcoming holidays

List the holidays a country has coming up in the next 365 days, without having to work out which year they fall in. Every holiday carries how many days away it is, so a scheduled workflow can act a fortnight before one. Narrow it to a state or region and to the holiday types that matter.

**Inputs**

- Country (`country`, text, required): The country to look up, chosen from the countries Nager.Date has holiday data for. The list is fetched from the API itself, so it is always current. A value from an earlier step can be a two-letter code such as 'DE' or a name such as 'Germany'; common alternatives like 'UK' and 'USA' work too.
- State or region (`subdivision`, text): Narrow to one state, province, canton or nation within the country, by its ISO 3166-2 code such as US-CA or DE-BY. The list is built from the subdivisions that country's holidays are actually attached to, so pick the country first. Leaving it empty returns everything the country has anywhere; setting it keeps the national holidays plus the ones that apply in that subdivision, which is the calendar someone there really keeps.
- Holiday types (`holiday_types`, list): Only holidays of these types. A year's list is not only days off: it also carries School, Optional and Observance entries, and an Observance such as Valentine's Day closes nothing. Leave it empty for every type, or pick Public for the days that are actually holidays. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off).
- National holidays only (`national_only`, true/false): Keep only the holidays that apply to the whole country, dropping the ones limited to particular states or regions. Off by default. Default: `false`.
- How many to return (`limit`, number): How many holidays to return, earliest first. Defaults to 50, which is more than any country has in a year. From 1 to 365. Default: `50`.

**Outputs**

- `count` (number): How many are returned
- `country_code` (text): The country looked up
- `country_name` (text): Its common name
- `dates` (list): Just the dates, ready to feed a later step
- `holiday_types` (list): The type filter applied, empty when every type is kept
- `holidays` (list)
- `matched_count` (number): How many matched before the limit
- `national_only` (true/false): Whether subdivision holidays were dropped
- `subdivision` (text): The subdivision filter applied, or null
- `total_count` (number): How many the window holds before filtering
- `window_days` (number): How far ahead the endpoint looks, in days

**Example output**

```json
{
  "count": 1,
  "country_code": "US",
  "country_name": "United States",
  "dates": [
    "2026-12-25"
  ],
  "holiday_types": [
    "Public"
  ],
  "holidays": [
    {
      "country_code": "US",
      "country_name": "United States",
      "date": "2026-12-25",
      "days_until": 120,
      "holiday_types": [
        "Public",
        "Bank"
      ],
      "is_public": true,
      "local_name": null,
      "name": "Christmas Day",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Friday"
    }
  ],
  "matched_count": 1,
  "national_only": false,
  "subdivision": null,
  "total_count": 9,
  "window_days": 365
}
```

### List upcoming holidays worldwide

List every country's holidays in the next seven days, in one step rather than one per country. Use it to tell a global team who is off this week, or to hold a send that would land on a holiday somewhere. Narrow it to the countries you operate in. These records carry the local-language name as well as the English one.

**Inputs**

- Countries (`countries`, list): Only these countries. Leave empty for every country with a holiday in the next seven days.
- Holiday types (`holiday_types`, list): Only holidays of these types. A year's list is not only days off: it also carries School, Optional and Observance entries, and an Observance such as Valentine's Day closes nothing. Leave it empty for every type, or pick Public for the days that are actually holidays. One or more of: `Public` (Public: a public holiday, and a day off), `Bank` (Bank: banks and offices are closed), `School` (School: schools are closed), `Authorities` (Authorities: government offices are closed), `Optional` (Optional: most people take the day off), `Observance` (Observance: marked, but not a day off).
- How many to return (`limit`, number): How many holidays to return, earliest first. Defaults to 100. From 1 to 500. Default: `100`.

**Outputs**

- `count` (number): How many are returned
- `countries` (list): The country filter applied, empty when every country
- `country_codes` (list): The countries actually present in the result
- `holiday_types` (list): The type filter applied, empty when every type is kept
- `holidays` (list)
- `matched_count` (number): How many matched before the limit
- `total_count` (number): How many the feed held before filtering
- `window_days` (number): How far ahead the feed looks, in days

**Example output**

```json
{
  "count": 1,
  "countries": [],
  "country_codes": [
    "SK"
  ],
  "holiday_types": [],
  "holidays": [
    {
      "country_code": "SK",
      "country_name": "Slovakia",
      "date": "2026-08-29",
      "days_until": 2,
      "holiday_types": [
        "Public"
      ],
      "is_public": true,
      "local_name": "Vyrocie Slovenskeho narodneho povstania",
      "name": "Slovak National Uprising anniversary",
      "national": true,
      "subdivision_codes": [],
      "weekday": "Saturday"
    }
  ],
  "matched_count": 1,
  "total_count": 26,
  "window_days": 7
}
```