FAQ

Answers about the Public Holidays API, the Festivo workspace (calendars, publish, widgets), and billing — before you open a ticket.

What countries and cities do you support?: We support 250+ countries, 5,500+ regions, and 1,000+ cities worldwide. Our database is continuously updated to ensure accuracy and coverage. Check our documentation for the full list of supported locations.
How accurate is your holiday data?: We maintain one of the most accurate holiday databases in the industry. Our data is sourced from official government sources, verified by local experts, and updated in real-time as changes are announced.
Do you support historical data?: Yes! We maintain historical holiday data going back several years, which is useful for analytics, reporting, and compliance purposes.
What languages are supported for holiday names?: We support 190+ languages for holiday and observance names. Each holiday can include translations in major languages, making it easy to build multilingual applications.
How is city-level data different from country-level?: Many holidays are observed only in specific cities or regions. For example, local patron saint days or regional festivals. City-level precision ensures you have accurate data for your specific location.
Does Festivo offer team holiday calendars beyond the REST API?: Yes. In the Festivo workspace at app.getfestivo.com, you can create named calendars, merge country/year sources, add blackout or working-day exceptions, and publish immutable versions so payroll, support, and product teams share one definition of holidays. See the holiday calendars & widgets guide on this site.
Can I expose our published calendar on our website or intranet?: Yes. Options include read-only public pages when your calendar has a slug (and optional org-branded URLs), a compact month widget you can iframe, ICS for calendars and saved views, and website widgets with scoped publish tokens and domain allowlists — all described in the portal guide.
What are business-day APIs and the Business Time Lab?: For each workspace calendar you can call APIs to check a working day, add or subtract business days, find the next working day, count working days inclusively between two dates, and compute working-hours overlap in minutes. Blackout and working exceptions you configure in the portal feed the same engine. Authenticated users can also open Business Time Lab under a calendar in the app to run those calls and inspect JSON responses.
Do website widget reads count against my Public Holidays API quota?: No. Widget traffic is metered separately (per workspace, per UTC day) from your Public Holidays API daily allowance. See the pricing comparison under “Website widget reads / day”.
What is your API uptime guarantee?: We maintain 99.9% uptime SLA for Pro and Enterprise plans. Our infrastructure is distributed across multiple regions with automatic failover to ensure reliability.
Can I use Festivo API for commercial projects?: Absolutely! All our plans, including the free tier, can be used for commercial projects. Enterprise customers get additional benefits like invoicing, PO support, and SEPA Direct Debit.
How does billing work?: Billing is based on API requests per day for the Public Holidays API. Unused requests do not roll over. Pro plans are billed monthly, and Enterprise plans can be customized with annual contracts. Workspace widget reads use a separate daily pool.
Is there a rate limit?: Rate limits vary by plan: Free tier allows 10 requests per minute, Pro allows 100 requests per minute, and Enterprise plans have custom limits based on your needs.
Do you offer SEPA Direct Debit?: Yes! Enterprise customers based in the EU can pay via SEPA Direct Debit, along with traditional invoicing and purchase order processing.
How do I get started?: Sign up for a free account at app.getfestivo.com, get your API key, and start making requests. Check our Getting Started guide for detailed instructions and code examples.
Can I test the API before committing?: Yes! Our free tier gives you 1000 requests per day to test and evaluate the API. No credit card required for the free tier.

Still have questions?

Browse the help center or reach the team from our contact page.

FAQ

Answers about the Public Holidays API, the Festivo workspace (calendars, publish, widgets), and billing — before you open a ticket.

What countries and cities do you support?: We support 250+ countries, 5,500+ regions, and 1,000+ cities worldwide. Our database is continuously updated to ensure accuracy and coverage. Check our documentation for the full list of supported locations.
How accurate is your holiday data?: We maintain one of the most accurate holiday databases in the industry. Our data is sourced from official government sources, verified by local experts, and updated in real-time as changes are announced.
Do you support historical data?: Yes! We maintain historical holiday data going back several years, which is useful for analytics, reporting, and compliance purposes.
What languages are supported for holiday names?: We support 190+ languages for holiday and observance names. Each holiday can include translations in major languages, making it easy to build multilingual applications.
How is city-level data different from country-level?: Many holidays are observed only in specific cities or regions. For example, local patron saint days or regional festivals. City-level precision ensures you have accurate data for your specific location.
Does Festivo offer team holiday calendars beyond the REST API?: Yes. In the Festivo workspace at app.getfestivo.com, you can create named calendars, merge country/year sources, add blackout or working-day exceptions, and publish immutable versions so payroll, support, and product teams share one definition of holidays. See the holiday calendars & widgets guide on this site.
Can I expose our published calendar on our website or intranet?: Yes. Options include read-only public pages when your calendar has a slug (and optional org-branded URLs), a compact month widget you can iframe, ICS for calendars and saved views, and website widgets with scoped publish tokens and domain allowlists — all described in the portal guide.
What are business-day APIs and the Business Time Lab?: For each workspace calendar you can call APIs to check a working day, add or subtract business days, find the next working day, count working days inclusively between two dates, and compute working-hours overlap in minutes. Blackout and working exceptions you configure in the portal feed the same engine. Authenticated users can also open Business Time Lab under a calendar in the app to run those calls and inspect JSON responses.
Do website widget reads count against my Public Holidays API quota?: No. Widget traffic is metered separately (per workspace, per UTC day) from your Public Holidays API daily allowance. See the pricing comparison under “Website widget reads / day”.
What is your API uptime guarantee?: We maintain 99.9% uptime SLA for Pro and Enterprise plans. Our infrastructure is distributed across multiple regions with automatic failover to ensure reliability.
Can I use Festivo API for commercial projects?: Absolutely! All our plans, including the free tier, can be used for commercial projects. Enterprise customers get additional benefits like invoicing, PO support, and SEPA Direct Debit.
How does billing work?: Billing is based on API requests per day for the Public Holidays API. Unused requests do not roll over. Pro plans are billed monthly, and Enterprise plans can be customized with annual contracts. Workspace widget reads use a separate daily pool.
Is there a rate limit?: Rate limits vary by plan: Free tier allows 10 requests per minute, Pro allows 100 requests per minute, and Enterprise plans have custom limits based on your needs.
Do you offer SEPA Direct Debit?: Yes! Enterprise customers based in the EU can pay via SEPA Direct Debit, along with traditional invoicing and purchase order processing.
How do I get started?: Sign up for a free account at app.getfestivo.com, get your API key, and start making requests. Check our Getting Started guide for detailed instructions and code examples.
Can I test the API before committing?: Yes! Our free tier gives you 1000 requests per day to test and evaluate the API. No credit card required for the free tier.

Still have questions?

Browse the help center or reach the team from our contact page.