Public Holidays and Working Days API: 150+ Countries
Pricing
$3.00 / 1,000 lookups
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
12 hours ago
Last modified
Categories
Features
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
| 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-daysto 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_TOKENwith 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)
| Action | Input | Result |
|---|---|---|
| holidays | GB (England), 2026 | 9 holidays, e.g. 2026-04-03 Good Friday, 2026-04-06 Easter Monday |
| add_working_days | DE, 5 working days from 2026-12-22 | 2026-12-30 (Wednesday) |
| current_time | Asia/Tokyo | 2026-10-25 20:55 JST (+0900), Sunday |
Use cases
- Scheduling agents: is it a working day there?
- Delivery/SLA dates: add N working days
- Payroll calendars by country
- 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_holidaysonly 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.