Public Holidaysas a Service
Know when the world stops — from national holidays down to city days. Same data in your API, calendars your team publishes, and widgets your visitors see.
Product update: team calendars & business time →No credit card • Free tier • 1,000 API calls/day
GET /v3/public-holidays/list
?country=IT
®ions=IT-MILAN
&year=2026
&api_key=YOUR_API_KEY1{2 "holidays": [3 {4 "name": "Feast of Saint Ambrose",5 "name_local": "Sant'Ambrogio",6 "date": "2026-12-07",7 "observed": "2026-12-07",8 "public": true,9 "type": "regional",10 "regions": [11 {12 "code": "IT-MILAN",13 "type": "city"14 }15 ]16 }17 ],18 "total": 1519}
Ship calendars, not spreadsheets
Combine countries, publish once, and reuse the same snapshot in your app, on a public page, or in a widget — with room for the odd custom working day.
Publish snapshots
Draft, compare, publish — so payroll, product, and support all point at the same holiday definition.
Working-day smarts
Blackout or “we’re open anyway” days feed the same engine your APIs use for counts, overlaps, and cut-offs.
Share anywhere
Feeds, public pages, and month, week, or agenda embeds — pick what fits customers vs colleagues.
Fewer surprises. Happier customers.
Local holidays break schedules when your stack only knows “country off”.
Missed Payroll Runs
Payroll slips when a city is open but your file says “national holiday”.
Failed Deliveries
Deliveries land on days locals treat as off — churn and refunds follow.
Compliance Violations
Rules differ by region; guesswork is not a compliance strategy.
Local where it matters
Ask for Milan, Munich, or Miami — not just “Italy” or “Germany”.
Regions that match your data model
Standard codes so filters stay consistent across teams and tools.
Local time, done right
Observances follow the clock people actually work on.
What makes Festivo unique?
Built for teams who ship software.
City-Level Precision
Go past country defaults — city and regional days your users actually get off.
Timezone-smart
Observances follow local clocks — fewer “off by one day” bugs.
Developer-First
Documentation, playground, calendars, business-time tools, widgets, and analytics — in one signed-in workspace.
Multilingual Support
Ship in 190+ languages without maintaining your own translation tables.
Global Coverage
Broad coverage you can stand behind in front of finance and legal.
Business Ready
GDPR-minded, invoicing-friendly, built for teams that ship in production.
One workspace for the whole team
Status, testing, calendars, embeds, and usage — together, so you spend less time wiring and more time shipping.
Dashboard
Health, usage, limits, and seats at a glance.
Open in appAPI Playground
Try real calls, inspect JSON, copy snippets.
Open in appHoliday Explorer
Browse and export holidays by country and year.
Open in appHoliday calendars
Build calendars, publish snapshots, share pages and embeds.
Open in appWebsite widgets
Safe read-only tokens and ready-made calendar views.
Open in appAnalytics
See traffic, errors, and headroom against your plan.
Open in appIntegrations
OpenAPI and Postman to get production faster.
Open in appCalendar & widget guide
Short tour of calendars, publish, and embeds on getfestivo.com.
Open on this siteAPI tokens & security
Create and rotate keys with team guardrails.
Open in app
