Loading...
Fast, simple Public Holidays API with comprehensive docs and official SDKs — plus a signed-in workspace with playground, explorer, analytics, and integration downloads. Start with 1,000 free API calls every day.
From zero to production in minutes
Create a free account in seconds and get your API key. Start with 1,000 free API calls every day — no credit card required.
Use curl, an SDK, or the API Playground in your Festivo workspace to fetch holiday data. Typical responses arrive in well under 100ms.
Follow our comprehensive guides, explore code examples, and build amazing features with reliable holiday data.
Clean, well-documented API that follows REST best practices
1require 'festivo'23client = Festivo::Client.new('YOUR_API_KEY')4holidays = client.get_holidays(country: 'IT', regions: 'IT-MILAN', year: 2026)5puts holidays
Production-ready libraries for your favorite programming language
1Maven:2<dependency>3 <groupId>io.github.festivo-io</groupId>4 <artifactId>festivo-sdk</artifactId>5 <version>0.2.1</version>6</dependency>78Gradle:9implementation 'io.github.festivo-io:festivo-sdk:0.2.1'
Everything you need to build with confidence
Clean, intuitive REST endpoints that follow best practices. JSON responses, standard HTTP status codes, and clear error messages.
Production-ready SDKs for Python, Node.js, PHP, Ruby, Go, Java, and more. TypeScript support, async/await, and comprehensive type safety.
After sign-in, use the API Playground for live production calls and snippets, and the Holiday Explorer for calendar views, exports, and country compare — without wiring curl first.
Publish org-scoped holiday calendars with exceptions and business-day APIs, then reuse them in ICS, public pages, embeddable month widgets, or token-backed site widgets — see the portal guide.
Track successful vs failed calls, daily usage, and plan quotas alongside service status, API key limits, and team seats from the dashboard.
Real-world code examples in multiple languages. Copy, paste, and customize for your use case.
Sub-100ms response times with global CDN and intelligent caching. Built to scale with your application.
Active community, comprehensive docs, and a clear in-app help center for billing, status, and integration links.
Workspace tools on app.getfestivo.com plus docs and SDKs on this site
Live requests, saved presets, and copy-paste snippets
Browse, filter, export, and compare holidays in the app
Usage charts and quota context for your workspace
OpenAPI, Postman, and onboarding artifacts
Complete API documentation with interactive examples
Step-by-step tutorial to get up and running in 5 minutes
Real-world examples in Python, Node.js, PHP, and more
Language-specific guides for our official SDKs
In-depth guides for common integration patterns
Latest updates, new features, and improvements
Get your free API key and start making requests in minutes. 1,000 free API calls every day — no credit card required.