The Holidays API provides holiday information on over 230 countries, regions, and territories around the world. It contains holiday data going back previous years as well as calendars in the future. The data incudes public holidays, different religious dates, bank holidays, and many other categories.
If you are only interested in public holidays, please use the Public Holidays API instead as it contains holiday data for many more years.
https://api.api-ninjas.com/v1/holidays
Returns a list of holiday entries for a given country and year. Each entry in the response contains the holiday name, date, day of the week, and the type of holiday.
country requiredCountry name or ISO 3166-2 country code (preferred).
year optionalpremium onlyCalendar year between 2010 and 2030 (inclusive). Default is the current year. Note: not all countries are guaranteed to contain data going back to 2010.
type optionalHoliday type filter. Possible values are:
major_holiday - combination of public_holiday, national_holiday, and federal_holiday |
public_holiday |
observance |
national_holiday |
federal_holiday (US only) |
season |
state_holiday |
optional_holiday |
clock_change_daylight_saving_time |
local_holiday |
united_nations_observance |
observance_christian |
bank_holiday |
common_local_holiday |
national_holiday_christian |
christian |
observance_hebrew |
jewish_holiday |
muslim |
hindu_holiday |
restricted_holiday |
official_holiday |
national_holiday_orthodox |
local_observance |
X-Api-Key requiredAPI Key associated with your account.
https://api.api-ninjas.com/v1/holidays?country=CA&year=2025&type=public_holidayHeaders
X-Api-KeyLog in or sign up to get your API Key1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
[
{
"country": "Canada",
"iso": "CA",
"year": 2025,
"date": "2025-09-01",
"day": "Monday",
"name": "Labour Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2025,
"date": "2025-05-19",
"day": "Monday",
"name": "Victoria Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2025,
"date": "2025-07-01",
"day": "Tuesday",
"name": "Canada Day",
"type": "PUBLIC_HOLIDAY"
},
...
]1
2
3
4
5
6
7
8
9
import requests
country = 'ca' # Canada.
year = '2025'
api_url = 'https://api.api-ninjas.com/v1/holidays?country={}&year={}'.format(country, year)
response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'})
if response.status_code == requests.codes.ok:
print(response.text)
else:
print("Error:", response.status_code, response.text)If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.