Public holidays and business days API
Get a country's public holidays for a year and add or count business days that skip weekends and holidays.
What it does
Public holidays for a country and year, and business-day math that skips weekends and holidays. Turkey includes the half-day eves.
- GET /v1/holidays?country=TR&year=2026
- POST /v1/business-days
Limits: No regional bank holidays as closed days, no administrative leave (idari izin) added by decree, no company closures.
Use cases
- Compute delivery and payment due dates.
- Block holidays in booking calendars.
- Handle Turkish religious holidays and half-day eves correctly.
Data sources and freshness
Law 2429 and the Diyanet calendar for Turkey; Nager.Date for other countries.
Turkey is built in through 2027; other countries are fetched from Nager.Date.
Pricing
Every new account gets 100 free calls. Packs of 10,000 ($5), 100,000 ($15) and 250,000 calls ($29) never expire, or choose Unlimited for $39 a month. Only successful responses use a call. See pricing.
FAQ
How are Turkish holidays handled?
Turkey 2024–2027 is built in from Law 2429 and the Diyanet calendar, including half-day eves. Other countries use Nager.Date.
Does it include administrative leave (idari izin)?
No. Leave added later by decree, regional bank holidays and company closures are not included.