Holidays API
Holidays API for implementing holiday information on over 230 countries, regions, and territories around the world
This holidays API made by API Ninjas delivers data for implementing holiday information on over 230 countries, regions, and territories around the world. The API covers global data. When filtering the system based on the country, year and type (can be public_holiday, observance, national_holiday, 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 and local_observance) you will get the output that you need for your system. Clients use it in the tourism, travel, marketing, consumer analysis and more sector. A few examples of the type of company using the API are calendar app developers, consumer analysts, travel planning platforms, religion-related websites and more, generally the customers are small business, medium business and enterprises. It is intriguing to read about new programs using this holiday data, it is possible to imagine some use cases with this data but several ideas are; website plugins, calendar applications, holiday market analysis, religion-related news feeds and websites and more. Developers often think of new ways to take advantage of the data from the API system and build something new.
Menu
Holidays API endpoints
GET |
/v1/holidays |
GET | /v1/holidays |
In order to use this platform for implementing holiday information on over 230 countries, regions, and territories around the world, clients need to communicate with the API endpoint; /v1/holidays to receive a similar output as in the response of the example. For the available objects and parameters, check the object table of the holidays API which describes it. In order to make request, put the data endpoint into the URL field. Using your API key parameter and connecting it to your private key, you can begin receiving data by using any of the leading programming languages.
Holidays API filter methods
The holidays API has the below mentioned filtering parameters applicable that you can filter with.
Filters | ||
country |
||
year |
||
type |
(can be public_holiday, observance, national_holiday, 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 and local_observance) |
Data object attributes
Obtain the data output from the API with the different parameters applicable and the table to interpret the objects.
Objects | Description |
country | Requested country |
iso | 2-digit counttry code |
year | Requested year |
date | Day of the week |
day | Holiday date in YYYY-MM-DD formatt |
name | Holiday name |
type | Holiday type |
Holidays output response
Here is an example response output of the endpoint request. There is more data accessible, it is limited to be able to make it more readable. Subscribe for the API system and receive the full response.
[
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-04-02",
"day": "Friday",
"name": "Good Friday",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-09-06",
"day": "Monday",
"name": "Labour Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-12-25",
"day": "Saturday",
"name": "Christmas Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-01-01",
"day": "Friday",
"name": "New Year's Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-04-05",
"day": "Monday",
"name": "Easter Monday",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-05-24",
"day": "Monday",
"name": "Victoria Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-07-01",
"day": "Thursday",
"name": "Canada Day",
"type": "PUBLIC_HOLIDAY"
},
{
"country": "Canada",
"iso": "CA",
"year": 2021,
"date": "2021-11-11",
"day": "Thursday",
"name": "Remembrance Day",
"type": "PUBLIC_HOLIDAY"
}
]
SDK
There are SDKs accessible to support the designing of your system, just ask for them and they should be sent. After this use the filter objects to select the right output for you and with the holiday API output in JSON your project will be possible to build.
Holidays API pricing
Samples and trials are free upon request, just make contact and inquire for it. Clients should be able to access the national holidays data and check if it is indeed that which clients are looking for. After testing it, people can determine if they want to work with the premium version.
Cost and price of API
API Ninjas data access is available to purchase monthly from $9 inclusive of API documentation and constant provider support.
Option | Price |
Monthly subscription | From $9/month |
Variable pricing | no |
Free Trial
Free trial is available
Further details
The database goes back until years, this allows you to obtain historical public holidays data with the API as well.
Alternative options

Menu