Public Holidays and Working Days API: 150+ Countries avatar

Public Holidays and Working Days API: 150+ Countries

Pricing

$3.00 / 1,000 lookups

Go to Apify Store
Public Holidays and Working Days API: 150+ Countries

Public Holidays and Working Days API: 150+ Countries

Public holidays for 150+ countries, plus working-day maths (is a working day, add or count business days, custom weekends) and a time-zone / world-clock lookup. Official calendar data for scheduling and payroll.

Pricing

$3.00 / 1,000 lookups

Rating

0.0

(0)

Developer

Tudor Lane

Tudor Lane

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

12 hours ago

Last modified

Features

Limited permissions

Share

Use when…

  • You need public holidays or business-day maths for a country or region.
  • You need current local time or a time-zone conversion for scheduling.
  • A calendar, logistics or payroll agent must set deadlines that skip weekends and holidays.

Price: $0.003 per lookup

Try this input

Copy-paste this JSON as the Actor input (it matches a successful run / the default schema):

{
"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"
}
]
}

Sample output (real run 2026-10-25)

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"
},
"… +7 more"
],
"source": "python-holidays 0.107",
"error": null
}

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

actionfieldsreturns
holidayscountry, subdivision?, yearall public / bank holidays
is_working_daycountry, datetrue/false + reason
next_working_day / previous_working_daycountry, dateresult_date
add_working_dayscountry, start_date, days (± )result_date (e.g. payment or delivery deadlines)
count_working_dayscountry, start_date, end_dateworking days (inclusive) + holidays in range
current_timetimezone (IANA or city)local time, UTC offset
convert_timedatetime, from_timezone, to_timezoneconverted time (handles daylight saving)
countriesnonesupported 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.

Sample output (real run with the default input, 25 Oct 2026)

ActionInputResult
holidaysGB (England), 20269 holidays, e.g. 2026-04-03 Good Friday, 2026-04-06 Easter Monday
add_working_daysDE, 5 working days from 2026-12-222026-12-30 (Wednesday)
current_timeAsia/Tokyo2026-10-25 20:55 JST (+0900), Sunday

Use cases

  1. Scheduling agents: is it a working day there?
  2. Delivery/SLA dates: add N working days
  3. Payroll calendars by country
  4. Meeting planners: time zone conversion

Limits & failure modes

  • Holiday data from the open python-holidays library; rare local or one-off holidays may be missing
  • Regional holidays only where the library supports them
  • Holiday coverage follows the bundled python-holidays dataset; obscure local observances can be missing.
  • Custom weekend_days / extra_holidays only apply when you pass them — defaults are Sat/Sun.
  • Invalid IANA time zones return an error for that request item.

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.