Changelog

All notable changes to the Festivo API and platform.

[3.2.1] - 2026-06-13

Added

HiBob scheduled sync — optional background refresh of company calendar signals into Festivo, with server-side throttling aligned to HiBob rate guidance.

Changed

HiBob team integration — clearer audit and operator visibility around verify, snapshot apply, and time-off proxy paths where the vendor API permits writes.
Marketing site — slimmer primary navigation (Product / Company), footer grouped by intent, and dedicated resource pages for calendars & widgets, business time, and user webhooks (/resources/...).

[3.2.0] - 2026-06-12

Added (portal & workspace)

This release is intentionally large: it introduces governed holiday calendars and public/embed surfaces, expands business-time APIs, and ships a rebuilt customer portal across dashboard, playground, holidays, analytics, calendars, embeds, saved views, integrations, billing, onboarding, and support — while keeping the Public Holidays API as the continuity layer for existing integrations.

Holiday calendars & publishing

Named workspace calendars composed from authority sources (countries, regions, years) with human-friendly display names.
Draft → review → immutable publish with full version history and side-by-side version compare so approvers see exactly what changed.
Per-calendar timezone and working-hours profile so published snapshots match how the business operates locally.
Blackout dates and working-day exceptions layered on top of official data and carried into publish.
Organization-scoped access and calendar membership so teams collaborate without casually sharing production API keys.

Business time

REST helpers: check a date, add / subtract business days, next working day, inclusive business-day count (subscription-aware).
Working-hours overlap API for SLA-style scheduling questions.
Authenticated Business Time Lab per calendar to probe the same engine your code calls.

Public web, embeds, and ICS

First-party public read-only calendar pages (month, week, agenda) with stable slugs.
Optional org-branded public URLs when a team configures a public slug.
Hosted embed widget path (/embed/calendar-widget.js on the portal host) with scoped publish tokens and origin controls where the plan allows.
ICS exports for published calendars from authenticated workspace flows and embed-oriented flows where applicable.
Dedicated Widgets (embeds) workspace for token rotation, allowlists, previews, and read limits.

Developer productivity & automation

Saved views to persist explorations (regions, years, filters) and reopen them with the team.
User webhook endpoints with signed payloads and test delivery from the portal.
Integrations hub surfacing first-party connections in one place.
Playground persistence plus OpenAPI & Postman export.
Holidays explorer watchlists, compare mode, and read-only share links.

Portal shell, guidance, and operations

Rebuilt navigation, layout, responsive behaviour, and dark mode across the major app routes.
In-app notification centre (bell) combining subscription health, onboarding gaps, seat usage, daily quota, and API reachability.
Quota and lifecycle banners (trial, past due, cancel scheduled, on-hold).
Shared analytics cache powering dashboard, bell, and banners so counters refresh after playground / explorer usage.
Help hub, structured support intake, and footer What’s new with versioned in-app notes.

Account, team, billing, and admin

Magic link, Google, GitHub, and passkey sign-in improvements; real names on self-serve join.
Team invites, roles, organization switching, and activity views where enabled.
Enterprise OIDC / SAML administration surfaces for owners and admins.
Privacy & communications toggles (marketing vs product-announcement mail) with operational mail clearly separate.
API token lifecycle improvements (rename, last-used ordering, onboarding deep links).
Self-serve billing: payment methods, EU tax identifiers, invoices, purchase orders, subscription management.
Festivo operator admin console for cross-tenant teams, subscriptions, usage, invoices, and support tooling.

Marketing site, docs, and email hygiene

Landing, pricing, FAQs, blog, comparisons, and documentation expanded for calendars, embeds, and business time.
Postmark webhooks (bounces, subscription changes), suppression state in product, and bounce-rate safeguards for optional mail.

[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 city parameter (Pro plan)
🏙️ Structured regions field with code and type properties

API Response Enhancements

📋 New dataVersion field for tracking data schema versions
⚠️ New deprecated field for advance notice of API changes
📍 Enhanced regions field replacing legacy subdivisions (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

🔄 subdivisions field now complemented by structured regions field
📈 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 subdivisions field 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 language parameter
🕐 Timezone conversion via timezone parameter
📄 XML format support via format parameter
🔍 Advanced filtering with before and after parameters
🎯 Holiday type filtering with type parameter

Changed

Updated base URL to v3 endpoint
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
deprecated field 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.

Changelog

All notable changes to the Festivo API and platform.

[3.2.1] - 2026-06-13

Added

HiBob scheduled sync — optional background refresh of company calendar signals into Festivo, with server-side throttling aligned to HiBob rate guidance.

Changed

HiBob team integration — clearer audit and operator visibility around verify, snapshot apply, and time-off proxy paths where the vendor API permits writes.
Marketing site — slimmer primary navigation (Product / Company), footer grouped by intent, and dedicated resource pages for calendars & widgets, business time, and user webhooks (/resources/...).

[3.2.0] - 2026-06-12

Added (portal & workspace)

Holiday calendars & publishing

Named workspace calendars composed from authority sources (countries, regions, years) with human-friendly display names.
Draft → review → immutable publish with full version history and side-by-side version compare so approvers see exactly what changed.
Per-calendar timezone and working-hours profile so published snapshots match how the business operates locally.
Blackout dates and working-day exceptions layered on top of official data and carried into publish.
Organization-scoped access and calendar membership so teams collaborate without casually sharing production API keys.

Business time

REST helpers: check a date, add / subtract business days, next working day, inclusive business-day count (subscription-aware).
Working-hours overlap API for SLA-style scheduling questions.
Authenticated Business Time Lab per calendar to probe the same engine your code calls.

Public web, embeds, and ICS

First-party public read-only calendar pages (month, week, agenda) with stable slugs.
Optional org-branded public URLs when a team configures a public slug.
Hosted embed widget path (/embed/calendar-widget.js on the portal host) with scoped publish tokens and origin controls where the plan allows.
ICS exports for published calendars from authenticated workspace flows and embed-oriented flows where applicable.
Dedicated Widgets (embeds) workspace for token rotation, allowlists, previews, and read limits.

Developer productivity & automation

Saved views to persist explorations (regions, years, filters) and reopen them with the team.
User webhook endpoints with signed payloads and test delivery from the portal.
Integrations hub surfacing first-party connections in one place.
Playground persistence plus OpenAPI & Postman export.
Holidays explorer watchlists, compare mode, and read-only share links.

Portal shell, guidance, and operations

Rebuilt navigation, layout, responsive behaviour, and dark mode across the major app routes.
In-app notification centre (bell) combining subscription health, onboarding gaps, seat usage, daily quota, and API reachability.
Quota and lifecycle banners (trial, past due, cancel scheduled, on-hold).
Shared analytics cache powering dashboard, bell, and banners so counters refresh after playground / explorer usage.
Help hub, structured support intake, and footer What’s new with versioned in-app notes.

Account, team, billing, and admin

Magic link, Google, GitHub, and passkey sign-in improvements; real names on self-serve join.
Team invites, roles, organization switching, and activity views where enabled.
Enterprise OIDC / SAML administration surfaces for owners and admins.
Privacy & communications toggles (marketing vs product-announcement mail) with operational mail clearly separate.
API token lifecycle improvements (rename, last-used ordering, onboarding deep links).
Self-serve billing: payment methods, EU tax identifiers, invoices, purchase orders, subscription management.
Festivo operator admin console for cross-tenant teams, subscriptions, usage, invoices, and support tooling.

Marketing site, docs, and email hygiene

Landing, pricing, FAQs, blog, comparisons, and documentation expanded for calendars, embeds, and business time.
Postmark webhooks (bounces, subscription changes), suppression state in product, and bounce-rate safeguards for optional mail.

[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 city parameter (Pro plan)
🏙️ Structured regions field with code and type properties

API Response Enhancements

📋 New dataVersion field for tracking data schema versions
⚠️ New deprecated field for advance notice of API changes
📍 Enhanced regions field replacing legacy subdivisions (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

🔄 subdivisions field now complemented by structured regions field
📈 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 subdivisions field 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 language parameter
🕐 Timezone conversion via timezone parameter
📄 XML format support via format parameter
🔍 Advanced filtering with before and after parameters
🎯 Holiday type filtering with type parameter

Changed

Updated base URL to v3 endpoint
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
deprecated field 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.