Holidays API
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.
/v1/holidays GET
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.
Parameters
countryrequiredCountry name or ISO 3166-2 country code (preferred).
yearoptionalpremium onlyCalendar year between
2010and2030(inclusive). Default is the current year. Note: not all countries are guaranteed to contain data going back to 2010.typeoptionalHoliday type filter. Possible values are:
major_holiday- combination ofpublic_holiday,national_holiday, andfederal_holidaypublic_holidayobservancenational_holidayfederal_holiday(US only)seasonstate_holidayoptional_holidayclock_change_daylight_saving_timelocal_holidayunited_nations_observanceobservance_christianbank_holidaycommon_local_holidaynational_holiday_christianchristianobservance_hebrewjewish_holidaymuslimhindu_holidayrestricted_holidayofficial_holidaynational_holiday_orthodoxlocal_observance
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Sample Request Live Demo!
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 KeySample Response
1
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"
},
...
]Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/holidays?country=US&year=2024" \
-H "X-Api-Key: YOUR_API_KEY"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.