M
API Matrix

Festivo Public Holidays API

Calendar / API Key Intermediate HTTPS CORS
Varies by plan (check documentation)
82 Score
Grade A
Visit Official Site Compare Alternatives

Overview

Festivo is a public holidays API covering more than 60 countries with regional subdivision support, providing both national and state/province-level holidays. It is one of the few holiday APIs that enables CORS by default, making it directly callable from browser JavaScript. An API key from getfestivo.com is required.

💡

Beginner Tip

Festivo supports CORS, so you can call it from a browser or frontend app without a backend proxy. Pass your key in the X-API-KEY header on every request.

Available Data

stock price and symbol
open/close/high/low values
trading volume
market cap
historical price data
event dates and names

Example Response

JSON Response 
{
  "status": "success",
  "data": {
    "result": "Data from Festivo Public Holidays",
    "description": "Fastest and most advanced public holiday and observance service on the market",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

holidays[].name Official name of the public holiday.
holidays[].date Date of the holiday in YYYY-MM-DD format.
holidays[].country_code ISO 3166-1 alpha-2 country code for the holiday.
holidays[].subdivisions Region or state codes where this holiday applies; an empty array means nationwide.
holidays[].type Classification of the holiday, e.g., "public" or "observance".

Implementation Example 

const url = "https://docs.getfestivo.com/docs/products/public-holidays-api/intro";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized API key passed as a query parameter instead of a header
✓ Send the key in the header: -H "X-API-KEY: YOUR_KEY". Do not append it to the URL query string.
Missing regional holidays Subdivision code not specified for state/province-level holidays
✓ Add the optional "subdivision" query parameter (e.g., &subdivision=CA-ON for Ontario) to get region-specific holidays.
400 Bad Request on date range Querying a year outside the supported range
✓ Festivo typically supports up to 5 years into the future; check the docs for the exact supported year range.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 17/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS YES
Category Calendar
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →

Calendarific

72

Calendarific is a REST API that returns public holidays for over 230 countries and territories, supporting both Gregorian and non-Gregorian calendars.

API Key Intermediate HTTPS

Checkiday - National Holiday API

77

Checkiday is a holiday data API covering more than 5,000 national days and observances in the United States, including unofficial holidays like National Pizza Day.

API Key Intermediate HTTPS

Holidays

82

Holiday API (holidayapi.com) provides historical and current public holiday data for over 100 countries, dating back to 2015.

API Key Intermediate HTTPS

Public Holidays

92

Abstract's Public Holidays API delivers structured data about national, regional, and religious holidays for countries worldwide.

API Key Intermediate HTTPS

Church Calendar

⭐ Beginner's Pick
37

Church Calendar (calapi.inadiutorium.cz) is a free, no-auth REST API that returns the Roman Catholic liturgical calendar for any date or month.

No Auth Beginner 291ms