Business Days & Holidays API - 200 Countries, Time Zones

Public holidays, "add N working days" maths, working days between two dates, business-day checks and time zone lookup in one Actor call. For people building schedulers, SLA and deadline calculators, HR and payroll tools, logistics ETAs and AI agents who need to know "when is 5 working days from today in Germany?" without paying per call for a holiday API.

Quick start

Run with empty input: you get the current year's public holidays of the US. Change What to calculate and the fields, or send a list of queries in Batch queries to answer thousands in one run.

Input examples

1. Holidays of several countries

{ "operation": "holidays", "country": "US,GB,FR,TN", "year": 2027 }

2. Deadline: 10 working days from a date, Bavaria

{ "operation": "addWorkingDays", "country": "DE", "region": "BY", "date": "2026-12-18", "days": 10 }

3. A batch of mixed queries

{
  "queries": [
    { "op": "isBusinessDay", "country": "SA", "date": "2026-10-09" },
    { "op": "workingDaysBetween", "country": "FR", "start": "2026-05-01", "end": "2026-05-31" },
    { "op": "timezone", "city": "Tunis" },
    { "op": "timezone", "latitude": "40.7", "longitude": "-74.0", "at": "2026-07-01T12:00:00Z" }
  ]
}

Operations

op	Needs	Returns
holidays	country, optional region, year	One row per holiday: date, weekday, name, localName, types, global, regions, source.
addWorkingDays	country, start (or date), days (negative = backwards)	resultDate, resultWeekday, calendarDays, skipped weekend days and holidays.
workingDaysBetween	country, start, end, inclusive (default true: both ends counted)	workingDays, weekendDays, holidaysInRange.
isBusinessDay	country, date	isBusinessDay, isWeekend, isHoliday, holidayName.
timezone	latitude + longitude or city, optional at	timezone, utcOffset, observesDst, isDstNow, localTime.

Input guide

Field	What it does
operation, country, region, year, date, endDate, days, latitude, longitude, city	One simple query (several countries allowed for holidays).
queries	A batch; replaces the simple fields. Each item uses the keys above (op, country, start, ...).
holidaySource	auto (Nager.Date, then offline), nager, or offline (never calls the web).
includeObservances	Also count observances and optional days (off by default).
weekend	Override, e.g. fri,sat. Default is by country.
maxQueries	Safety limit.

Sample rows

{ "type": "holiday", "country": "TN", "year": 2026, "date": "2026-01-01", "weekday": "Thursday", "name": "New Year's Day", "localName": "عيد رأس السنة", "types": ["Public"], "global": true, "source": "date-holidays" }
{ "type": "addWorkingDays", "country": "US", "startDate": "2026-12-23", "days": 5, "resultDate": "2026-12-31", "calendarDays": 8, "skippedWeekendDays": 2, "skippedHolidays": [{ "date": "2026-12-25", "name": "Christmas Day" }] }

Use it with

Google Maps or lead scrapers (combine with the opening-hours and country normalizers), AI agents that schedule work, or any Apify task that needs a due date: call this Actor with a batch of queries and read the dataset.

FAQ

Which data is used? Nager.Date (open source holiday API, about 100 countries) when available, otherwise the offline date-holidays database (about 200 countries and many regions, no network). Each row says which.

Does it use the web? Only for Nager.Date in auto/nager mode. offline never does.

Are half days and bridge days included? No. Only full public and bank holidays count as non-working.

Honest limits

• Holiday dates for far-future years follow the calendar rules; dates fixed by decree (many Islamic and Chinese holidays) can be off by a day or be missing until announced.
• Weekends are by country, with a small built-in list of Friday-Saturday countries; companies with other schedules should set weekend.
• Regional holidays need the exact region code of the data source; unknown regions return only nationwide holidays or an error row.
• City time zones come from an offline list of about 7,000 cities; unknown cities need coordinates.

Price

Pay per event: $0.0005 per query answered (a holiday list for a whole year is one query; failed queries are free). 10,000 queries = $5.