# Nager.Date API: List public holidays

> Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.

Unofficial. Not affiliated with or endorsed by Nager.Date.

- Page: https://fous.com/methods/date.nager.at/list-public-holidays
- Method: `date.nager.at/list_public_holidays`, version 1
- Website: date.nager.at
- Returns: date, weekday, English and local names, regions, type, nationwide flag
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `year` | integer | no |  | Calendar year, for example 2026. Defaults to the current year. |
| `country` | string | yes | `"US"` | Country name or two-letter country code, for example Germany or DE. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "country": "US"
}
```

Its output:

```json
{
  "year": 2026,
  "holidays": [
    {
      "date": "2026-01-01",
      "type": "Public, Bank",
      "regions": [],
      "weekday": "Thursday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",
      "local_name": "New Year's Day",
      "nationwide": "yes",
      "english_name": "New Year's Day",
      "region_codes": []
    },
    {
      "date": "2026-01-19",
      "type": "Public, Bank",
      "regions": [],
      "weekday": "Monday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",
      "local_name": "Martin Luther King, Jr. Day",
      "nationwide": "yes",
      "english_name": "Martin Luther King, Jr. Day",
      "region_codes": []
    },
    {
      "date": "2026-02-12",
      "type": "Observance",
      "regions": [
        "California",
        "Connecticut",
        "Illinois"
      ],
      "weekday": "Thursday",
      "page_url": "https://date.nager.at/PublicHoliday/Country/US/2026",
      "local_name": "Lincoln's Birthday",
      "nationwide": "no",
      "english_name": "Lincoln's Birthday",
      "region_codes": [
        "US-CA",
        "US-CT",
        "US-IL"
      ]
    }
  ],
  "country_name": "United States"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"date.nager.at/list_public_holidays","input":{"country":"US"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What public holidays fall in Germany in 2026, and which ones apply only to certain states?
- I need a list of Japan's national holidays for 2025 with their local names in Japanese.
- Which days are bank holidays in the UK this year, and are any of them regional rather than nationwide?
- Show me the public holidays for DE in 2027 including the weekday for each date.
- Can you give me the French public holidays for 2024 along with their holiday types?

## Input schema

```json
{
  "type": "object",
  "required": [
    "country"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "maximum": 9999,
      "minimum": 1,
      "description": "Calendar year, for example 2026. Defaults to the current year."
    },
    "country": {
      "type": "string",
      "description": "Country name or two-letter country code, for example Germany or DE."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "country_name",
    "year",
    "holidays"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Calendar year returned."
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "date",
          "weekday",
          "english_name",
          "local_name",
          "nationwide",
          "regions",
          "type",
          "page_url",
          "region_codes"
        ],
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Holiday date."
          },
          "type": {
            "type": "string",
            "description": "Holiday classifications, including all applicable types."
          },
          "regions": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Region names where a regional holiday applies."
          },
          "weekday": {
            "type": "string",
            "description": "Day of the week."
          },
          "page_url": {
            "type": "string",
            "description": "Country holiday calendar page for this year."
          },
          "local_name": {
            "type": "string",
            "description": "Local holiday name."
          },
          "nationwide": {
            "enum": [
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Whether the holiday applies throughout the country."
          },
          "english_name": {
            "type": "string",
            "description": "English holiday name."
          },
          "region_codes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "ISO region codes where this regional holiday applies."
          }
        }
      },
      "description": "Holidays in date order. Nationwide holidays have no specific regions."
    },
    "country_name": {
      "type": "string",
      "description": "Name of the country."
    }
  }
}
```

## See more

- [Nager.Date API: Check public holiday](https://fous.com/methods/date.nager.at/check-public-holiday.md): Checks whether a date is a public holiday or weekend in a country. By default only nationwide holidays count; give a region to include holidays observed there.
- [Nager.Date API: Get country info](https://fous.com/methods/date.nager.at/get-country-info.md): Looks up a country on Nager.Date by name or two-letter code and returns its common and official names, code, region and land-border neighbours.
- [GOV.UK API: List bank holidays](https://fous.com/methods/gov.uk/list-bank-holidays.md): Lists GOV.UK bank holidays for a UK region and year, including substitute days and notes, plus the next upcoming holiday. Years GOV.UK does not publish return an empty list and the published years.
- [Time and Date API: Count business days](https://fous.com/methods/timeanddate.com/count-business-days.md): Counts weekdays between two dates, excluding nationwide public holidays or, optionally, public holidays in a state or province, from Time and Date's published holiday calendar.
- [Formula 1 API: Get race calendar](https://fous.com/methods/formula1.com/get-race-calendar.md): Gets a Formula 1 season calendar with venues, sprint weekends, status, and session start times in circuit local time or a chosen city or IANA time zone.
- [Ballotpedia API: List ballot measures](https://fous.com/methods/ballotpedia.org/list-ballot-measures.md): Lists statewide ballot measures in a US state and year, in Ballotpedia order, with election dates, topics, measure types, yes/no vote meanings and results. Years without statewide measures return an empty list.
- [Nasdaq API: Get dividend calendar](https://fous.com/methods/nasdaq.com/get-dividend-calendar.md): Lists Nasdaq dividend calendar entries going ex-dividend on a day (US Eastern), sorted by company name. Includes ETFs and other listed securities shown by Nasdaq; dividend yield is not shown by this calendar and is null.
- [Wikipedia API: Get Wikipedia On this day](https://fous.com/methods/wikipedia.org/get-on-this-day.md): Returns Wikipedia's On this day events, births, deaths and holidays for a month and day, in a chosen Wikipedia language; events, births and deaths come newest year first.
- [All Nager.Date methods](https://fous.com/methods/nager.at.md)