API Ninjas
4.7
4.7/5

[┐∵]-

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.

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

Sign up for API Ninjas holidays API

Get Data Access

~[ ∵ ]~

Sign-up Succesful

Wait for the Data