Holidays API for Developers

Global holidays API for fetch holidays list by countries, cities and region to integrate easily in any app.

Country*

Year*

See API docs →

The free plan allows you to fetch past holidays only. Sign up to get your api key for full access

230+ Countries

230+ countries holidays including the USA, UK, Canada, France, Germany, China, Japan, India and more.

7000+ Holidays

Over 7000+ holidays data accessible via API on federal, state, and local levels with simple GET requests

Holiday Types

Worldwide holidays including national holidays, bank holidays, and religious holidays.

Holidays API Documentation

Get holidays

To retrieve the complete holidays list by specific country code and year

Endpoint

GET https://api.11holidays.com/v1/holidays?country=[COUNTRY_CODE]&year=[YEAR]

Parameters

country (2 char) - Required. 2 character ISO country code.
year (integer) - Required. Year in 4 digit format.

Response

[ { "holiday_id": 1, "date": "2023-01-01", "occasion_id": 1, "type": "State Holiday", "country": "US", "name": "New Year's Day", "description": "Celebration of the first day of the Gregorian calendar year.", "created_at": "2023-10-28 15:10:10", "updated_at": null } ]

Status Codes

200 OK - Successful request. Holiday details are returned in the response.
404 Not Found - No holidays found for specified country.
500 Internal Server Error - An error occurred on the server while processing the request.

SDK

Install 11holidays package from NPM

npm install 11holidays

Import or require('11holidays') the library on your code and create an instance

import HolidaysApi from '11holidays';
const instance = new HolidaysApi(API_KEY);

Get the list of holidays by country, year

instance.holidays.list();
// To fetch by country 
// instance.holidays.list( {country: 'US'}); 
// To fetch by country and year 
// instance.holidays.list( {country: 'US', year: '2023'});