World Public Holidays, Working Days & Time Zones

What it does: Public holidays for 150+ countries and regions, working/business-day maths, current time and time-zone conversion, in one fast API.

Who it's for: Scheduling, logistics, payroll, customer-support and calendar agents that need deadlines and local times right.

Price: Pay per event: $0.003 per request (each item in requests). You only pay Apify for what you run; there is no monthly fee for this Actor.

A fast, offline public holidays API, business days / working days calculator and timezone converter for AI agents and automations. Covers 150+ countries and their regions/states (e.g. GB-ENG/SCT/WLS/NIR bank holidays, US states, German Länder).

Actions

action	fields	returns
holidays	country, subdivision?, year	all public / bank holidays
is_working_day	country, date	true/false + reason
next_working_day / previous_working_day	country, date	result_date
add_working_days	country, start_date, days (± )	result_date (e.g. payment or delivery deadlines)
count_working_days	country, start_date, end_date	working days (inclusive) + holidays in range
current_time	timezone (IANA or city)	local time, UTC offset
convert_time	datetime, from_timezone, to_timezone	converted time (handles daylight saving)
countries	none	supported countries and subdivisions

Optional on working-day actions: weekend_days (e.g. ["fri","sat"]) and extra_holidays (company closure dates).

Batch input

{"requests": [
 {"action": "holidays", "country": "GB", "subdivision": "ENG", "year": 2026},
 {"action": "add_working_days", "country": "DE", "start_date": "2026-12-22", "days": 5},
 {"action": "convert_time", "datetime": "2026-11-03T09:00", "from_timezone": "London", "to_timezone": "America/New_York"}]}

Bad requests return a row with error and are not charged.

Note: if a holiday falls on a weekend, both the holiday and its "(observed)" substitute day are listed where the country has one.

Pricing

One lookup event per successful result.

Data

Holiday rules from the open-source holidays Python package (MIT), bundled. Time zones from the IANA tz database. No external API calls, so it's fast and always available.

Keywords: public holidays API, bank holidays, business days calculator, working days calculator, add business days, holiday calendar, timezone converter, world clock, SLA deadline, payment due date, AI agent tool, MCP.

Quick example

Input

{
 "requests": [
  {
   "action": "holidays",
   "country": "GB",
   "subdivision": "ENG",
   "year": 2026
  },
  {
   "action": "add_working_days",
   "country": "DE",
   "start_date": "2026-12-22",
   "days": 5
  },
  {
   "action": "current_time",
   "timezone": "Tokyo"
  }
 ]
}

Output (one dataset item, shortened)

{
 "action": "holidays",
 "country": "GB",
 "subdivision": "ENG",
 "year": 2026,
 "count": 9,
 "holidays": [
  {
   "date": "2026-01-01",
   "name": "New Year's Day",
   "weekday": "Thursday"
  },
  {
   "date": "2026-04-03",
   "name": "Good Friday",
   "weekday": "Friday"
  },
  "..."
 ],
 "source": "python-holidays 0.107",
 "error": null
}

Use it from AI agents (MCP) and code

• Apify MCP server: add https://mcp.apify.com/?tools=tudorlane/world-holidays-working-days to Claude, Cursor, ChatGPT connectors, VS Code or any MCP client (sign in with Apify OAuth or an API token). The Actor appears as a tool the model can call.
• REST (sync): POST https://api.apify.com/v2/acts/tudorlane~world-holidays-working-days/run-sync-get-dataset-items?token=YOUR_TOKEN with the input JSON as the body; results come back in the response.
• SDKs / no-code: apify-client (Python/JS), LangChain, LlamaIndex, CrewAI, n8n, Make and Zapier integrations.

FAQ

Regional holidays? Yes, e.g. GB-SCT, US states, German Lander.

Custom weekends? Use weekend_days, e.g. ["fri","sat"], and extra_holidays for closures.

Daylight saving? Handled for every IANA time zone.

What if the source is down? You get an error row and are not charged for it.

Support? Open an issue on the Actor's Issues tab.

---

Keywords: public holidays API, bank holidays API, business days calculator, working days API, timezone converter API, world clock API, MCP tool, Apify Actor, AI agent tool.