Nager.Date
Public holidays API for 100+ countries — holiday names, dates, and types, plus long-weekend calculation and 'is today a holiday' checks. Open source, no key.
🟢 Online · 801 ms
100%
Unlimited (fair use), no key, no credit card
No key required
Free alternatives (live ranking)
- Free Dictionary API — 🟢 Online · Unlimited (fair use), no key, no credit card
- ipify — 🟢 Online · Unlimited, no key, no credit card
- DiceBear Avatars — 🟢 Online · Unlimited (fair use), no key, no credit card
Compare Nager.Date with…
- Nager.Date vs Free Dictionary API — Unlimited (fair use), no key, no credit card
- Nager.Date vs ipify — Unlimited, no key, no credit card
- Nager.Date vs DiceBear Avatars — Unlimited (fair use), no key, no credit card
Paid alternatives
- Calendarific — free 500/mo, paid from $10/mo
Frequently Asked Questions
Does Nager.Date require an API key?
No, Nager.Date is freely accessible without registration or an API key.
What is Nager.Date's free tier?
Unlimited (fair use), no key, no credit card
Is Nager.Date currently online?
We check Nager.Date every hour. The current status is shown at the top of this page. You can also see the 30-day uptime history in the chart above.
Implementation notes
When to use Nager.Date
Nager.Date answers 'is this a public holiday?' for 100+ countries — the question behind delivery-date estimators, business-day calculators, meeting schedulers, and payroll tools. Endpoints for a year's holidays by country, the next upcoming holidays, long weekends, and a direct boolean check for today. Open source (.NET, self-hostable), no key, and the data is maintained by an active community. For a category where commercial APIs charge real money, this is remarkably complete.
Common pitfalls
- Regional holidays are flagged via the `counties` field (e.g., German states, US states) — a null `counties` means nationwide. Business-day logic that ignores this will mark all of Germany closed for a Bavaria-only holiday.
- The `types` field distinguishes Public holidays from Bank, School, Optional, and Observance days. For 'is the post office open' logic you almost always want type Public only — including Observance days marks Valentine's Day as a day off.
- Coverage is strong for Europe, the Americas, and major Asian economies but thinner for smaller countries — check your specific target countries rather than trusting '100+ countries' for all of them equally.
- Religious holidays with non-Gregorian calculations (Easter-linked, lunar calendar) are computed, not hardcoded — historically accurate, but always verify the current year against an official source for payroll-grade use.
Quick start (bash)
curl "https://date.nager.at/api/v3/IsTodayPublicHoliday/FR"
# HTTP 200 = holiday, 204 = not a holidayEmbed this badge
Add a live status badge to your README, docs, or website.
Markdown
[](https://freeapi.watch/nager-date)HTML
<a href="https://freeapi.watch/nager-date"><img src="https://freeapi-builder.a10ayassine.workers.dev/badge/nager-date.svg" alt="Nager.Date Status"/></a>