Skip to content

Canada Holidays API API

by canada-holidays.ca

No authHTTPSOpen Data
Open documentation ↗

Overview

This API lists all 31 public holidays for all 13 provinces and territories in Canada, including federal holidays.

Canada Holidays API is an open data API from canada-holidays.ca. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 6 endpoints.

At a glance

Authentication
No auth
HTTPS
Yes
CORS
Unknown
Category
Open Data
Base URL
https://canada-holidays.ca
Version
1.8.0
Endpoints
6
Spec updated
2023-02-17

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://canada-holidays.ca/api/v1" \
  -H "Accept: application/json"
JavaScript
const response = await fetch("https://canada-holidays.ca/api/v1", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://canada-holidays.ca/api/v1",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/api/v1root
GET/api/v1/holidaysGet all holidays
GET/api/v1/holidays/{holidayId}Get a holiday by id
GET/api/v1/provincesGet all provinces
GET/api/v1/provinces/{provinceId}Get a province or territory by abbreviation
GET/api/v1/specGet JSON schema

Questions

Does the Canada Holidays API API need an API key?

No. The Canada Holidays API API can be called without an API key or sign-up, which makes it handy for prototypes and front-end demos.

Does the Canada Holidays API API support HTTPS?

Yes, the Canada Holidays API API is served over HTTPS.

How many endpoints does the Canada Holidays API API have?

Its OpenAPI description lists 6 endpoints in version 1.8.0. All of them are shown on this page.

What are alternatives to the Canada Holidays API API?

Other Open Data APIs include Search Services, Wayback API, Wikipedia, Nasdaq Data Link, University of Oslo.

Compare alternatives →

Listed from APIs.guru (CC0).