Changelog
All notable changes to the Festivo API and platform.
[3.1.0] - 2026-02-15
Added
City-Level Holiday Support
- ✨ 1,000+ cities now supported worldwide
- 🇮🇹 Comprehensive coverage for Italian patron saint days and local festivals
- 📍 City-specific queries via new
cityparameter (Pro plan) - 🏙️ Structured
regionsfield withcodeandtypeproperties
API Response Enhancements
- 📋 New
dataVersionfield for tracking data schema versions - ⚠️ New
deprecatedfield for advance notice of API changes - 📍 Enhanced
regionsfield replacing legacysubdivisions(backward compatible) - 🌍 Improved subdivision detection and classification
Performance Improvements
- ⚡ Cached requests now return in under 100ms
- 🔄 Access-aware cache keys based on subscription entitlements
- 📈 Optimized database queries and aggregation pipelines
- 🎯 Subscription-aware filtering at database layer
Platform Updates
- 🛡️ Upgraded error monitoring to Sentry 10.38.0
- 📊 Enhanced request tracing and performance logging
- ⚡ Improved error handling and defensive validation
- ⏱️ Better system stability and uptime
Documentation & Website
- 🌐 Brand new landing page built with Next.js 16
- 📱 Fully responsive design with dark mode support
- 📚 Enhanced documentation hub with interactive API reference
- 💼 Industry-specific use cases and tutorials
- ❓ Expanded FAQ section
- 📝 New blog and changelog pages
Pricing & Experience
- ✨ Updated plan names (Explorer, Builder, Growth, Pro, Titan)
- 🎨 Redesigned pricing page with transparent savings
- 🌍 Automatic currency detection (EUR/USD)
- 📊 Enhanced plan comparison table
Changed
- 🔄
subdivisionsfield now complemented by structuredregionsfield - 📈 Improved API response consistency across all endpoints
- 🎨 Updated documentation with city-level examples throughout
Backward Compatibility
- ✅ All existing integrations continue to work without changes
- ✅ Legacy
subdivisionsfield remains fully functional - ✅ New fields are optional and additive
- ✅ No breaking changes to API contracts
[3.0.0] - 2025-11-01
Added
- 🌍 Support for 190+ languages via
languageparameter - 🕐 Timezone conversion via
timezoneparameter - 📄 XML format support via
formatparameter - 🔍 Advanced filtering with
beforeandafterparameters - 🎯 Holiday type filtering with
typeparameter
Changed
- Updated base URL to
v3endpoint - Improved response structure with consistent field naming
- Enhanced error messages and codes
[2.5.0] - 2025-08-15
Added
- ISO 3166-2 subdivision support
- Regional holiday filtering
- Substitute holiday detection
- Weekday information in responses
Improved
- Database query performance
- API response times
- Documentation clarity
[2.0.0] - 2025-03-01
Added
- RESTful API architecture
- JSON response format
- Authentication via API keys
- 250+ country coverage
- Historical data back to 2000
- Future data up to 5 years
Initial Release
- Public holiday data API
- Country-level queries
- Basic filtering (year, month, day)
- English language support
Versioning Policy
Festivo follows semantic versioning:
- Major version (3.x.x): Breaking changes requiring code updates
- Minor version (x.1.x): New features, backward compatible
- Patch version (x.x.1): Bug fixes and improvements
Deprecation Policy
When we deprecate features:
- Announcement at least 6 months in advance
deprecatedfield appears in API responses- Migration guide provided in documentation
- Feature continues to work during deprecation period
- Final removal only after transition period
Upcoming Features (Roadmap)
Q1 2026 (Completed ✓)
- ✓ City-level holiday support
- ✓ Structured regions field
- ✓ Enhanced documentation
Q2 2026 (In Progress)
- 🔄 Webhooks for holiday data updates
- 🔄 Bulk query API for multiple countries
- 🔄 Historical change tracking
Q3 2026 (Planned)
- 📅 School holiday calendars
- 🎊 Festival and event data
- 🌙 Lunar calendar support
Q4 2026 (Planned)
- 🤖 AI-powered holiday predictions
- 📱 Mobile SDKs (iOS, Android)
- 🔗 GraphQL API endpoint
Stay Updated
Subscribe to updates:
- Blog: getfestivo.com/blog
- Email Newsletter: Subscribe
- Status Page: status.getfestivo.com
- GitHub: Follow SDK repositories for library updates
Report Issues
Found a data discrepancy or bug?
- Email: support@getfestivo.com
- Subject: Include country code and holiday name
- Details: Provide official source/link if possible
We typically respond within 24 hours and fix verified issues within 48 hours.