Canada Holidays Ca Canada Holidays API

Name: Canada Holidays API
Brand: Canada Holidays API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentData EnrichmentData Transformationnone6 EndpointsREST

For Agents

Look up the 31 Canadian public holidays across all 13 provinces and territories with a free, unauthenticated REST API.

Install Jentic One Beta

Connect the Canada Holidays API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Canada Holidays API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Canada Holidays API.

List every Canadian public holiday for the current or a specified year via /api/v1/holidays

Retrieve a single holiday by numeric ID via /api/v1/holidays/{holidayId}

List the 13 provinces and territories with their observed holidays via /api/v1/provinces

GET STARTED

Start building with Canada Holidays API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Canada Holidays API for, with concrete tasks.

★ Payroll Scheduling for Canadian Employers

Payroll systems need to advance pay dates that fall on statutory holidays and to apply holiday-pay multipliers. The /api/v1/provinces/{provinceId} endpoint returns the holidays observed in a specific province, letting payroll software flag affected days at the right jurisdiction without maintaining a static holiday table.

GET /api/v1/provinces/ON to retrieve Ontario's observed holidays for the current year and shift any pay date matching a holiday to the previous business day.

HR and Booking Calendar Integration

HR portals and booking systems display Canadian holidays so employees and customers can plan time off and appointments. /api/v1/holidays returns every observed holiday with its date and observing provinces, ready to render directly in a calendar UI.

GET /api/v1/holidays for the next 12 months and render each entry as a calendar event with the federal flag and observing provinces.

Compliance Date Validation for Contracts

Legal and compliance workflows must avoid scheduling deadlines on statutory holidays. The /api/v1/holidays endpoint paired with the federal flag in each holiday entry lets a compliance bot check whether a proposed deadline falls on a holiday before sending the document.

GET /api/v1/holidays for the contract's year, scan for the proposed deadline date, and warn if it matches a federal or provincial holiday.

AI Agent Scheduling Workflows via Jentic

Through Jentic, an agent searches for 'list Canadian public holidays', loads the input schema for /api/v1/holidays, and executes the call. Because the API is unauthenticated, Jentic exposes it directly; an agent gains the same intent-based discovery as authenticated APIs without holding any credential.

Use the Jentic SDK to search 'list Canadian public holidays', load the /api/v1/holidays operation schema, and execute it with year=2026 to return all observed dates.

Key Endpoints

6 endpoints — the canada holidays api exposes all 31 public holidays observed across canada's 13 provinces and territories, including federal holidays.

METHOD

PATH

DESCRIPTION

GET

/api/v1/holidays

List all Canadian public holidays

GET

/api/v1/holidays/{holidayId}

Retrieve a single holiday by ID

GET

/api/v1/provinces

List all provinces and their observed holidays

GET

/api/v1/provinces/{provinceId}

Retrieve a province by two-letter abbreviation

GET

/api/v1/holidays

List all Canadian public holidays

GET

/api/v1/holidays/{holidayId}

Retrieve a single holiday by ID

GET

/api/v1/provinces

List all provinces and their observed holidays

GET

/api/v1/provinces/{provinceId}

Retrieve a province by two-letter abbreviation

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Canada Holidays API requires no authentication, so no credential is held in the Jentic vault. Agents can execute the operation directly through Jentic with no setup beyond the operation reference.

Intent-based discovery

Agents search by intent (for example, 'list Canadian public holidays') and Jentic returns the matching operation along with its input schema, so the agent can call /api/v1/holidays without browsing the Swagger doc.

Time to first call

Direct integration: under an hour. Through Jentic: under 15 minutes to search, load, and execute.

FAQs

Specific to using Canada Holidays API through Jentic.

What authentication does the Canada Holidays API use?

The API is fully unauthenticated. No API key, OAuth token, or basic credential is required. Through Jentic, the operation can be executed directly with no vault credential attached, which makes it a useful starter API for testing the search-load-execute flow.

Can I look up holidays for a specific province?

Yes. Call GET /api/v1/provinces/{provinceId} with the two-letter abbreviation (for example, ON, QC, BC) to retrieve that province's observed holidays. /api/v1/provinces returns the full list of provinces with their holidays in one response.

How many holidays does the API cover?

It covers all 31 public holidays observed across Canada's 13 provinces and territories, including federal holidays. Each holiday entry indicates whether it is federal and which provinces observe it.

How do I check whether a date is a Canadian holiday through Jentic?

Use the Jentic SDK to search 'check Canadian holiday'. Jentic returns the GET /api/v1/holidays operation. Execute it for the relevant year, then in the agent compare the target date to each returned holiday's date and observing provinces.

Are there rate limits on the Canada Holidays API?

The OpenAPI specification does not document rate limits. The service is run as a free public utility, so be courteous with request volume and cache responses on your side. Holiday data only changes once a year per province.

Is the Canada Holidays API free?

Yes. The API is offered free of charge with no API key required. The maintainer accepts donations on canada-holidays.ca but there is no paid tier.