holidays.com

Get Your Holidays API Key

Buy a plan and get instant access to holiday data for 230+ countries

Pro Plan

Annual subscription

  • Unlimited API requests
  • Access to all 230+ countries
  • Commercial use allowed

$99 /year

Lifetime Access

One-time payment

  • All Pro Plan features
  • No recurring payments
  • Priority support

$249 forever

What is the Holidays API?

The 11holidays Holidays API is a REST API for public holidays, bank holidays and observances in 230+ countries. Send a GET request with a country code and year, and it returns federal, state and local holidays as JSON, with each holiday's name, date, type and description.

HR and leave management

Show the right public holidays for employees in each country.

Payroll

Account for bank holidays when calculating pay dates and working days.

Booking and scheduling

Block out holidays and plan around closures in your calendars.

API Documentation

Base URL

https://api.11holidays.com/v1

Endpoints

GET /holidays?country=US&year=2026
Holidays for a country and year
GET /holidays/{id}
A single holiday by id
GET /countries
Supported countries
GET /occasions
Holidays and festivals with descriptions

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Example response

[
  {
    "holiday_id": 6093,
    "name": "New Year's Day",
    "date": "2026-01-01",
    "description": "...",
    "occasion_id": 6220,
    "country": "US",
    "type": "Federal Holiday"
  }
]
Learn more in the API docs
API Examples
Quick start examples in different programming languages
curl -X GET "https://api.11holidays.com/v1/holidays?country=US&year=2026" \
  -H "Authorization: Bearer YOUR_API_KEY"
Learn more in the API docs

Frequently asked questions

What is the 11holidays Holidays API?

It is a REST API that returns public holidays, bank holidays and observances for 230+ countries as JSON. You request holidays by ISO 3166-1 alpha-2 country code and year.

How do I get a Holidays API key?

Buy the Pro or Lifetime plan on this page. After payment you return here to generate your key, and we also email it to the address you used at checkout.

How much does the Holidays API cost?

The Pro plan is $99 per year and Lifetime access is a one-time payment of $249. Both plans include unlimited API requests and all 230+ countries.

Is there a free Holidays API?

The REST API requires a paid plan. Free iCal calendar feeds for each country are available without an API key.

Which countries does the Holidays API cover?

It covers 230+ countries. Call GET /countries for the full list of supported countries and their codes.

Can I get holidays for past years?

Yes. Historical data is included, so you can request past years with the year parameter.

How do I authenticate API requests?

Send your key in the Authorization header of every request: Authorization: Bearer YOUR_API_KEY.

Is there an SDK or OpenAPI spec?

Yes. Install the official npm package with npm i 11holidays, or generate a client from the OpenAPI 3.0 spec linked in the API docs.