API Ninjas
5/5
5/5

[┐∵]-

Holidays API

Holidays API for implementing holiday information on over 230 countries, regions, and territories around the world
This API Ninjas holidays API provides data for implementing holiday information on over 230 countries, regions, and territories around the world. The API is used by small business, medium business and enterprises, certain examples of the type of company that uses the data are calendar app developers, consumer analysts, travel planning platforms, religion-related websites and more. The customers use the API in the tourism, travel, marketing, consumer analysis and more industry. 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 response that you need for your system. There are countless platforms that are being developed with the use of the public holidays data. Programmers constantly come with new ideas for using the data, let’s provide you with certain potential cases; website plugins, calendar applications, holiday market analysis, religion-related news feeds and websites and more and of course there are much more clients can think of. This database covers global data.

Holidays API endpoints

GET

/v1/holidays

Send a data request using GET to the API endpoint, with the possible filter object like in the example and get the associated data output. Use the endpoint; /v1/holidays for implementing holiday information on over 230 countries, regions, and territories around the world with the holiday system. Place the API endpoint into the URL to execute the data request. The API documentation works with all leading coding languages, simply attach the API key parameter to the data endpoint URL and set it to your personal API key to begin receiving the requested data. The object table defines the applicable objects and parameters output descriptions.

Filters for holidays API

Below you can see the applicable filter parameters in relation to the holidays data.
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 description

Clarify the objects and the description with the table to be able to make use of the API system also make use of the applicable parameters to be able to receive the needed response output.
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 API response output

Subscribe to the API to request the complete output responsebut you can already see a preview of the output response in the code box.
				
					[
  {
    "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"
  }
]
				
			

Software development kits

This is a JSON API and if people would like SDKs, they are available for phyton, r, matlab, c++, node. Js, go, php, haskell, net, java, javascript, typescript,tensorflow and ruby. Simply request it and they will be provided. Begin using the filter attributes and combine the response with the SDKs and design the project.

Holidays API pricing

Make contact with the API provider to ask for access to trials and samples of the API so that you can play with the API ahead of deciding to purchase the complete package access. The sample access is limited but should be able to provide you with a good insight into the complete system.

Price and cost of API

API Ninjas Holidays API is accessible with the price tag starting monthly from $9 with 3D secure payment.
Option Price
Monthly subscription From $9/month
Variable pricing no

Free Trial

Free trial is available

More information

In the event that clients would like historical national holidays data, this is also accessible with the API, the API has history till years.

Alternative options

Sign up for API Ninjas holidays API

Get Data Access

~[ ∵ ]~

Sign-up Succesful

Wait for the Data