Tools / Public Holidays Calendar: 200+ Countries, States & Regions

Public Holidays Calendar: 200+ Countries, States & Regions

Get public, bank and school holidays for 200+ countries and their regions. Input: countries. Output (JSON/CSV): one row per item with region, country, date, name, type, weekday, substitute, source, license.

Run it on Apify Store →

What it's for

Business-day and delivery-date calculations
Payroll and scheduling calendars for multi-country teams
Avoid booking shoots or campaigns on local holidays

Example input

{
 "countries": [
  "US",
  "US-TX",
  "GB",
  "DE-BY",
  "XX"
 ],
 "years": [
  "2026"
 ],
 "types": [
  "public",
  "bank"
 ]
}

Example output

{
  "region": "US",
  "country": "United States of America",
  "year": 2026,
  "date": "2026-01-01",
  "name": "New Year's Day",
  "type": "public",
  "weekday": "Thursday",
  "substitute": false,
  "start": "2026-01-01T05:00:00.000Z",
  "end": "2026-01-02T05:00:00.000Z",
  "rule": "01-01 and if sunday then next monday if saturday then previous friday",
  "source": "date-holidays (github.com/commenthol/date-holidays)",
  "license": "Data CC BY-SA 3.0; code ISC"
}

Input reference

Field	Type	Notes
`countries` required	array	ISO codes, optionally with region: US, US-CA, GB, DE-BY, FR, JP.
`years`	array	Leave empty for this year and next.
`types`	array	Any of: public, bank, school, optional, observance. Empty = all.

Pricing

Pay per event: Holiday record $0.0002. Plus Apify's small per-run start fee. Apify's free plan includes monthly credit to try it.

How to run

Open the Store page and click Try for free.
Fill in the input (or paste the example JSON in the JSON tab).
Click Start, then export results as CSV, Excel or JSON, or call it via the Apify API.
Optional: add a Schedule and a webhook/Slack/email integration for ongoing monitoring.

Open Public Holidays Calendar on Apify →