API Ninjas — Holidays API

API Ninjas offers a powerful and comprehensive holidays API that allows users to access detailed information about national holidays from around the world. Listed on Worldindata, our API enables developers to easily integrate holiday data into a wide range of applications and services, such as website plugins, calendar applications, holiday market analysis, religion-related news feeds and websites, and more.

Holidays API Code Examples

API Ninjas provides detailed documentation for our holidays API, including code examples for the GET /v1/holidays endpoint. This endpoint allows users to retrieve information about national holidays for a specific country and year, making it easy to incorporate up-to-date holiday data into any application.

[
  {
    "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"
  }
]

Get World In Data’s stories in your inbox

Join Medium for free to get updates from this writer.

Remember me for faster sign in

The JSON output describes a list of national holidays in Canada for the year 2021. Each holiday is represented by an object with the following properties: country, iso, year, date, day, name, and type. The country is always Canada, the iso is the country code for Canada, the year is 2021, the date is the date of the holiday in YYYY-MM-DD format, the day is the day of the week on which the holiday falls, the name is the name of the holiday, and the type is always PUBLIC_HOLIDAY. The list includes holidays such as Good Friday, Labour Day, Christmas Day, New Year’s Day, Easter Monday, Victoria Day, Canada Day, and Remembrance Day.

Industries and Purpose of National Holidays API

API Ninjas’ national holidays data is useful for a wide range of industries and purposes. Our API can be used to power website plugins that display upcoming holidays, calendar applications that help users plan their schedules around national holidays, and even holiday market analysis for businesses looking to understand consumer behavior during major holidays. Additionally, the API can be used by religion-related news feeds and websites to provide accurate information about religious holidays.

API Price Structure

API Ninjas offers a flexible pricing structure for our national holidays database, starting at just $9 per month. Our API is also listed on the API marketplace, Worldindata, making it easy for users to access and purchase.