Canada Holidays

Canada Holidays API

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

Data & analytics#openapi#open-data

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

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

Endpoints 6

info

  • GETroot/api/v1Returns a welcome message.
  • GETGet JSON schema/api/v1/specGets the schema for the JSON API as a yaml file.

holidays

  • GETGet all holidays/api/v1/holidays?year=2023&federal=1&optional=falseReturns Canadian public holidays. Each holiday lists the regions that observe it.
  • GETGet a holiday by id/api/v1/holidays/:holidayId?year=2023&optional=falseReturns one Canadian statutory holiday by integer id. Returns a 404 response for invalid ids.

provinces

  • GETGet all provinces/api/v1/provinces?year=2023&optional=falseReturns provinces and territories in Canada. Each province or territory lists its associated holidays.
  • GETGet a province or territory by abbreviation/api/v1/provinces/:provinceId?year=2023&optional=falseReturns a Canadian province or territory with its associated holidays. Returns a 404 response for invalid abbreviations.

API details

Base URL
https://canada-holidays.ca
Authentication
None declared in the description
Operations
6 operations on 6 pathsGET 6
Main resources
holidays 2info 2provinces 2
Response formats
application/json
Description format
OpenAPI 3.0.0, API version 1.8.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the Canada Holidays API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Canada Holidays API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “root” (GET /api/v1), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Canada Holidays API?

This API lists all 31 public holidays for all 13 provinces and territories in Canada, including federal holidays. It is listed under Data & analytics and has 6 endpoints.

Who publishes the Canada Holidays API?

It is listed from Canada Holidays's public API description (an OpenAPI document), not published by Canada Holidays on Swastik Codes. Anyone who controls canada-holidays.ca can claim the profile by adding a DNS TXT record.

What is the base URL of the Canada Holidays API?

Requests go to https://canada-holidays.ca. Endpoint paths are added to this base URL.

How do I authenticate with the Canada Holidays API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the Canada Holidays API have?

6 operations on 6 paths (6 GET). The largest groups are holidays, info, provinces.

Is forking the Canada Holidays API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.