Public Holidays API by Country and Year

Look up public holidays with an ISO two-letter country code and an optional year. Review returned dates, names, holiday types and available regional details.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu Tool holiday-calendar-strale. Convert the country name the user provides into the matching ISO two-letter country code for queryParams.country_code; do not ask the user to look up a code. If the country could mean more than one place, ask a simple clarifying question. Ask for a country only when none is provided. Add queryParams.year only when the user requests a year; otherwise omit it to use the current year. Present returned entries with their actual dates, names and types, and preserve any returned regional details. Keep same-date entries separate when their type or region differs. Do not infer workplace or school closures, employee leave entitlement, or coverage beyond the response. Recommend checking local applicability with the relevant authority before planning. Follow the user’s budget and authorization.

Task:
Find public holidays in [United States] for [2026]. List each date and holiday name, and keep entries for different regions separate.

Paste into your connected AI's conversation.

Connection guide

Up to 0.028512 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Strale

Public Holidays API by Country and Year

Look up public holidays with an ISO two-letter country code and an optional year. Review returned dates, names, holiday types and available regional details.

You receive

Request a public holiday list for one country and year. A returned entry may include its date, name, type, fixed-date status, scope, region codes or local name when those details are available. Repeated dates can represent different holiday types or regions.

Start with your task

Find public holidays in [United States] for [2026]. List each date and holiday name, and keep entries for different regions separate.

What to know

This is a holiday-data lookup, not a workplace or school closure calendar or a determination of employee leave. Coverage and regional details depend on the returned data. Confirm local applicability with the relevant authority before making plans.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `country_code`
Year`queryParams.year`	`integer`	Optional	Optional calendar year. Leave blank to use the current year.
Country code`queryParams.country_code`	`string`	Required	Required ISO two-letter country code for the holiday lookup.

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "required": [
        "country_code"
      ],
      "properties": {
        "year": {
          "type": "integer",
          "description": "Year; defaults to the current year."
        },
        "country_code": {
          "type": "string",
          "description": "ISO two-letter country code."
        }
      }
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Public holiday lookup by country and year

Enter an ISO two-letter country code and an optional year to request a holiday list. Strale lists Nager.Date as the data source and describes coverage across 200+ countries. A response may include a date, holiday name and type, plus any fixed-date, scope, region-code or local-name details supplied for that entry. Multiple entries can share a date when their type or regional scope differs.

See Strale’s holiday-calendar capability listing and the Nager.Holidays API reference for source context. The returned list is not a workplace or school closure schedule; confirm local applicability before making plans.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Enter an ISO two-letter country code, such as US or GB.

Public Holidays API by Country and Year

Public Holidays API by Country and Year

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Public holiday lookup by country and year

Choose a country by its usual name

Choose a year if needed

Check holidays for your area

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Public holiday lookup by country and year

Choose a country by its usual name

Choose a year if needed

Check holidays for your area

Questions about this tool.

Which country code should I enter?

What year is used if I leave the year blank?

Does this tell me whether my workplace or school is closed?