holidays.list

Public and bank holidays for a country or state in a year, plus a business-day check.

DataLaunch set1 unit per call24 h cacheMCP: holidays_listv1.0.0

When to use it

Use for holiday calendars, or to check whether a date is a business day, for example when counting working days toward a deadline. Computed offline, so it is fast and always available.

Input

Field	Type	Description
`country` *	`string`	ISO 3166-1 alpha-2 code, e.g. US, DE, JP.
`subdivision`	`string (1+ chars, ≤ 10 chars)`	State or region code, e.g. CA for California in the US.
`year`	`integer (≥ 1900, ≤ 2100)`	Year. Defaults to the current UTC year.
`include_observances`	`boolean`	Also include observances and optional days, not only public and bank holidays. Default: false.
`on`	`string`	Date YYYY-MM-DD to check for business-day status.

* required

Output

Returns data with: country, subdivision, year, holidays: [{date, name, type}], count, on: {date, is_weekend, holiday, is_business_day}.

Request

curl -X POST https://agentops.tools/v1/holidays.list \
  -H 'content-type: application/json' \
  -d '{"country":"US","subdivision":"CA","year":2026,"on":"2026-07-04"}'

Over MCP the tool is named holidays_list. Over A2A its skill id is holidays.list. Same input, same envelope.

Try it

Input (JSON)

Counts against your rate limit.

Sources

date-holidays (offline dataset)

Holiday data from the date-holidays project (MIT)

Notes

Holiday rules come from the date-holidays project. Confirm official observances for legal or payroll decisions.