Public Holidaysas a Service
Accurate, timezone-aware, and subdivision-specific holidays worldwide — with city-level precision for 1000+ cities.
No credit card required • Free tier available • 1000 requests/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}
One API, Zero Holiday Conflicts
Stop losing revenue to missed holidays and compliance issues
Missed Payroll Runs
City-specific holidays cause payroll errors when systems only track national holidays
Failed Deliveries
Delivery apps schedule shipments on local holidays, causing customer complaints and lost revenue
Compliance Violations
Missing regional observances leads to labor law violations and penalties
City-Level Granularity
Query holidays by city code (IT-MILAN, IT-ROME, DE-MUNICH) using the regions parameter to catch local observances like patron saint days
ISO-Coded Subdivisions
Standard ISO 3166-2 codes for regions and structured data for precise filtering
Timezone-Aware Observances
Correct local observance times with timezone conversion for global operations
What makes Festivo unique?
Designed for developers, built for businesses
City-Level Precision
Not just country-wide data. Get city-level holidays and local observances for 1000+ cities with ISO-coded subdivisions.
Timezone & Observance-Aware
Accurate local observances with timezone conversion. Know exactly when holidays are observed in any location worldwide.
Developer-First
Clear docs, SDKs in multiple languages, powerful filters, and code examples ready to use. Built by developers, for developers.
Multilingual Support
Holiday and observance names in 190+ languages, perfect for international applications.
Global Coverage
250+ countries, 5,500+ regions, and 1,000+ cities. Comprehensive worldwide holiday data you can trust.
Business Ready
GDPR-compliant, with proper invoicing, PO process support, SEPA Direct Debit, and EU-based infrastructure.
