Festivo Public Holidays API

Calendar / API Key Intermediate HTTPS CORS

Varies by plan (check documentation)

82 A

Metadata Score Metadata estimate · not endpoint-tested

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

Request

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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

How is this scored? →