Holidays

API

API for historical and upcoming global holiday data

Overview

The Holidays API provides RESTful access to historical and upcoming holiday information across 100+ countries. Endpoints allow filtering by country code, year, date range, or specific date, returning JSON responses with details like holiday name, date, type (public, observance), and region. Use cases include integrating holiday calendars into apps, scheduling tools for global teams, historical cultural research, and automating holiday-related notifications or workflows.

Example Integration (JavaScript)

script.js JS


fetch('https://holidayapi.com/')
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err));

Key Features

RESTful API
JSON Responses
100+ Country Coverage
Historical & Upcoming Data
Filter by Country/Year/Date

Frequently Asked Questions

? Is Holidays API free to use?

Yes, it offers a free tier with limited monthly requests; paid plans unlock higher limits and advanced features like unlimited access.

? Does it require an API Key?

Yes, an API key is mandatory for all requests, including the free tier, to authenticate and track usage.

? What is the response format?

All responses are in JSON format, containing detailed holiday attributes such as name, date, type, country code, and region.

Top Alternatives

Nager.Date API Search Google

Calendarific API Search Google

Tool Info

Pricing Freemium

Category Calendar

Platform Public API

Pros

⊕ Easy to Integrate
⊕ Comprehensive Metadata
⊕ Reliable Uptime
⊕ Regular Data Updates

Cons

⊖ Rate Limits on Free Tier
⊖ Paid Plans for Advanced Access
⊖ Limited Historical Depth for Some Regions