DOCSEARCHbyAlgolia
Submit Docs

Festivo Public Holidays API

website·Indexed 32 days ago

https://getfestivo.com/docs

A public holidays API and platform providing data for countries, ISO-standard subdivisions, and city-level holidays. It includes features for HR and payroll integration, business-day logic, team holiday calendars, and embeddable website widgets. The platform supports V3 API and offers SSO via OpenID Connect (OIDC).

Tokens
12.1K
Snippets
24
Records
119
Agent score
61%

What's inside Festivo

  1. Overview of Festivo's Public Holidays API and Workspace features

    Festivo provides a Public Holidays API for programmatic data retrieval, but distinguishes itself from basic JSON endpoints by offering a comprehensive workspace. This workspace includes features such as publishable calendars, business-time calculations, HR synchronization, enterprise sign-in, and webhooks.

  2. Utilize the Festivo B2B Operations Portal

    The Festivo portal provides a suite of tools for managing API usage and B2B operations:

    • Developer Tools: A playground with persisted requests, OpenAPI/Postman exports, a holidays explorer with watchlists, and usage-aware analytics.
    • B2B Billing: Support for EU tax IDs, invoicing, and purchase orders (on supported plans).
    • Support: A structured help hub, support intake, and public status page.

  3. Use SEPA Direct Debit for Festivo payments

    Festivo supports SEPA (Single Euro Payments Area) Direct Debit for European customers. This standardized system allows for euro-denominated payments across Europe, specifically designed to streamline enterprise procurement and recurring B2B payments. Key benefits include automated invoice payments, avoidance of credit card fees/international transfer costs, and predictable payment schedules.

  4. Understand Festivo's GDPR compliance and data handling

    Festivo's API is designed as a strictly read-only system that does not store or process personal data. This architecture eliminates the need for users to manage data residency, user consent, or breach notification requirements under GDPR. The system follows a data minimization strategy, collecting only the minimum technical data (such as request logs for abuse prevention) required for API operation, with no user-identifiable information stored.

  5. Utilize the Festivo B2B Operations Portal

    The Festivo portal provides a suite of tools for managing holiday data and API usage:

    • Developer Tools: A playground with persisted requests, OpenAPI/Postman exports, and a holidays explorer with watchlists.
    • Analytics: Usage-aware analytics to monitor API consumption.
    • Billing & Admin: Support for EU tax IDs, invoices, purchase orders (on supported plans), and a centralized notification center.

  6. Festivo Public Holidays API coverage and capabilities

    The Festivo Public Holidays API supports 250+ countries, 5,500+ regions, and 1,000+ cities worldwide. It provides historical holiday data for analytics and compliance, and supports holiday and observance names in 190+ languages for multilingual applications.

  7. Manage holiday data with Festivo's control plane

    Unlike basic holiday APIs that only provide JSON responses, Festivo provides a control plane (workspace) that allows product, HR, and operations teams to define and govern holiday data before it is deployed to production. This ensures that APIs, ICS feeds, and widgets all use a single, aligned definition of a holiday.

  8. Deploy holiday data via widgets, ICS, and public pages

    Festivo provides several ways to surface holiday data beyond a machine-readable API:

    • Public Pages: First-party read-only calendar views (month, week, agenda) with stable, bookmarkable URLs.
    • ICS Exports: Standard calendar exports for integration with personal calendars.
    • Embeddable Widgets: Hosted widgets using scoped publish tokens and origin controls for security.
    • Branding: Optional organization-branded public paths for intranet and marketing use.

  9. Embed Festivo Calendars via Widget

    You can embed read-only calendars on public pages using the hosted embed widget. This requires a scoped publish token and origin controls configured in the Widgets workspace within the portal.
    <script src="https://[portal-host]/embed/calendar-widget.js"></script>

  10. Publish holiday data via public pages, ICS, and widgets

    Festivo allows organizations to expose holiday data through multiple human-readable and machine-readable formats:

    • Public Pages: Read-only calendar views (month, week, agenda) with stable, bookmarkable URLs.
    • ICS Exports: Standard calendar exports for external integration.
    • Embeddable Widgets: Hosted widgets using scoped publish tokens and origin controls (available on supported plans).
    • Branded Paths: Optional organization-branded public namespaces for intranets and marketing surfaces.

  11. Manage Healthcare and Medical appointment scheduling

    Integrate holiday-aware booking and staff shift planning to reduce patient no-shows and optimize hospital/clinic resource allocation during public and local holidays.

  12. Handle shipping estimates and promotions in E-commerce

    Integrate Festivo's real-time API to adjust shipping estimates and display country-specific promotions based on local holidays to manage customer expectations.