Is a holiday
Tool ID: holidaycalendar_is_holiday
Summary
Checks one calendar date and tells you whether it is a holiday in a country, with the matching holiday names when it is.
When to use it
- You have a meeting or a shipping date and need to know if offices are closed.
- You want the holiday name for a date you already know, such as 25 December.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Extra service login | No |
Parameters
| Parameter | Required? | Description |
|---|---|---|
date |
Yes | The day to check, as a calendar date such as 2026-12-25. |
country_code |
Yes | Two-letter country code, such as US. |
subdivision_code |
No | Region code such as US-NY. Nationwide holidays still count, plus holidays for that region. |
holiday_types |
No | Leave it out to check public holidays. Ask for all types, or for a specific kind such as school. |
national_only |
No | Set this to ignore days that apply only in some regions. |
What you get back
Whether the date matched (is_holiday), and the holiday records for that day. Several records can match one date when regions or holiday types differ.
Example prompts
Is 25 December 2026 a public holiday in the United States?
Is 26 December 2026 a public holiday in New York?
Is 1 May 2026 a school holiday in Germany, or only a public holiday?
Tips
- The date has to fall in a year the service publishes. That is currently the previous calendar year through five years ahead.
- For “is it a holiday today”, use Today so the timezone can be included.