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
- OpenAPI
- Specification ↗
- Spec updated
- 2023-02-17
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://canada-holidays.ca/api/v1" \
-H "Accept: application/json"const response = await fetch("https://canada-holidays.ca/api/v1", {
method: "GET",
headers: {
"Accept": "application/json",
},
});
const data = await response.json();
console.log(data);import requests
response = requests.request(
"GET",
"https://canada-holidays.ca/api/v1",
headers={
"Accept": "application/json",
},
timeout=30,
)
print(response.json())Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /api/v1 | root |
| GET | /api/v1/holidays | Get all holidays |
| GET | /api/v1/holidays/{holidayId} | Get a holiday by id |
| GET | /api/v1/provinces | Get all provinces |
| GET | /api/v1/provinces/{provinceId} | Get a province or territory by abbreviation |
| GET | /api/v1/spec | Get 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.
Similar open data APIs
Compare alternatives →Search Services
Open DataAPI for Internet Archive's Search-related services
Wayback API
Open DataAPI for Internet Archive's Wayback Machine
Wikipedia
Open DataMediawiki Encyclopedia
Nasdaq Data Link
Open DataThe source for financial, economic, and alternative datasets, serving investment professionals.
University of Oslo
Open DataCourses, lecture videos, detailed information for courses etc. for the University of Oslo (Norway)
Data API
Open DataServes the Clever Data API
Listed from APIs.guru (CC0).