Israel Business Days, Jewish Holidays & Shabbat Times API

Calculate Israeli business days, list Jewish and Israeli holidays (in English or Hebrew), convert dates to the Hebrew calendar, get the weekly Torah portion (parsha) and Shabbat candle-lighting and havdalah times for 21 Israeli cities or any coordinates — in one fast, deterministic API.

Built for developers, ops teams and AI agents that need to answer questions like:

• "If we ship on Thursday before Sukkot, when is 5 business days later in Israel?"
• "How many working days are there in April 2027 in Israel?"
• "Is 21 September 2026 a working day?" (No – Yom Kippur.)
• "When does Shabbat start in Haifa this Friday?"

Why this Actor?

• 🇮🇱 Israeli work week built in: Sunday–Thursday, Friday/Saturday weekend (Friday optional), statutory rest days (Rosh Hashana, Yom Kippur, Sukkot, Shemini Atzeret, Pesach I & VII, Shavuot) and Yom Ha'atzmaut with the official postponement rules (moved when it falls on Friday, Saturday or Monday). Verified against Hebcal for 2024–2031.
• 🕍 Full holiday calendar: fasts, Hanukkah, Purim, Shushan Purim, Lag BaOmer, Tu BiShvat, Tu BeAv, Yom HaShoah, Yom HaZikaron, Yom Yerushalayim, with Hebrew names ("language": "he").
• 🕯️ Shabbat times using local customs: 40 minutes before sunset in Jerusalem, 30 in Haifa, 20 elsewhere; havdalah at 8.5° below the horizon. Matches Hebcal within ±1 minute (60 city/date checks).
• ⚡ Pure computation: no scraping, no third-party API, no rate limits, no personal data. Results in about a second.
• 🤖 Agent-ready: call it from the Apify API, Make, n8n, Zapier, LangChain or as an MCP tool via the Apify MCP server.

Operations

operation	Use it for	Main inputs	Output (one row per…)
holidays	Holiday calendar for a date range	startDate, endDate, language	holiday day
dayInfo	Check specific dates	dates[]	date: Hebrew date, holidays, isBusinessDay, isRestDay, isErev, parsha
addBusinessDays	SLA / delivery / deadline dates	startDate, businessDays (can be negative)	calculation
countBusinessDays	Working days between two dates (end inclusive)	startDate, endDate	calculation
shabbatTimes	Candle lighting & havdalah	city or latitude+longitude, startDate, weeks	Shabbat

Options: fridayIsBusinessDay (default false), cholHamoedIsBusinessDay (default true; the intermediate days of Sukkot/Pesach are legal working days but many offices close), candleLightingMinutes (override the city custom).

Examples

Deadline in 10 business days, starting the Thursday before Sukkot 2026

{ "operation": "addBusinessDays", "startDate": "2026-09-24", "businessDays": 10 }

{ "startDate": "2026-09-24", "businessDays": 10, "resultDate": "2026-10-08", "weekday": "Thursday", "hebrewDateHe": "כ״ז תשרי תשפ״ז" }

Is it a working day? (Hebrew names)

{ "operation": "dayInfo", "dates": ["2026-09-21"], "language": "he" }

{ "date": "2026-09-21", "weekday": "Monday", "hebrewDateHe": "י׳ תשרי תשפ״ז", "holidays": ["יום כיפור"], "isRestDay": true, "isBusinessDay": false, "isErev": false, "parsha": null }

Shabbat times in Tel Aviv for the next 4 weeks

{ "operation": "shabbatTimes", "city": "Tel Aviv", "startDate": "2026-10-20", "weeks": 4 }

{ "city": "Tel Aviv", "friday": "2026-10-23", "candleLighting": "2026-10-23T17:39+03:00", "havdalah": "2026-10-24T18:36+03:00", "parsha": "Lech Lecha", "parshaHe": "לך לך" }

Full sample outputs are in the Actor's example runs.

Calling it from code

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("harushlabs/israel-business-days-jewish-holidays").call(
    run_input={"operation": "countBusinessDays", "startDate": "2027-04-01", "endDate": "2027-04-30"}
)
print(next(client.dataset(run["defaultDatasetId"]).iterate_items()))

Pricing

$0.002 per result row (one holiday, one date, one calculation or one Shabbat). A full-year holiday calendar is about 40 rows ≈ $0.08; a business-day calculation is $0.002.

Accuracy, scope and disclaimers

• Holidays follow the Israeli (not diaspora) calendar. Ad-hoc national holidays (for example election days) and sector-specific closures are not included.
• Shabbat times are astronomical calculations at sea level with common Israeli customs. They are not halachic rulings; follow your community's calendar for religious observance.
• Chol HaMoed and erev chag handling vary between employers; use the options above to match your policy.

Open-source components

Hebrew calendar: pyluach (MIT). Astronomy: python-zmanim (LGPL-2.1+, used unmodified). City coordinates: GeoNames (CC BY 4.0).

Feedback

Missing a city, a holiday rule or a business-day convention you need? Open an issue on the Issues tab.