Canada Holidays API

Name: Canada Holidays API 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.

Quickstart

Get started with Canada Holidays API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"list Canadian public holidays"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Canada Holidays API 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

Look up a province or territory by two-letter abbreviation via /api/v1/provinces/{provinceId}

GET STARTED

Start building with Canada Holidays API API

Explore with Jentic

View OpenAPI Document

Use for: List all Canadian federal holidays for this year, Check whether a given date is a holiday in Ontario, Get the holidays observed in British Columbia, Find the next public holiday in Alberta

Not supported: Does not handle US holidays, religious observance dates, business-day calculations, or time-zone conversions — use for Canadian federal and provincial public-holiday lookups only.

Jentic publishes the only available OpenAPI document for Canada Holidays API, keeping it validated and agent-ready.

The Canada Holidays API exposes all 31 public holidays observed across Canada's 13 provinces and territories, including federal holidays. Six GET endpoints return the full holiday list, single holidays by ID, every province with its observed holidays, and a province by abbreviation. The API requires no authentication and is well suited for scheduling, payroll, and HR-tooling agents that need authoritative Canadian holiday dates.

Use Cases

Patterns agents use Canada Holidays API 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 though 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.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Nager.Date Public Holidays API

Nager.Date covers public holidays in 100+ countries, where the Canada Holidays API focuses solely on Canada with provincial-level detail.

Choose Nager.Date when the agent needs holidays across multiple countries; choose Canada Holidays API for richer provincial and territorial detail within Canada.

Alternative

Abstract Public Holidays API

Abstract offers a paid global holidays API behind an API key, where the Canada Holidays API is free and Canada-specific.

Use Abstract when the agent needs commercial SLA and global coverage; use Canada Holidays for free Canadian-only lookups.

Complementary

Google Calendar API

Google Calendar manages user calendars and events, where Canada Holidays supplies the statutory holiday data to layer onto those calendars.

Pair Google Calendar for event creation with Canada Holidays to inject statutory holiday entries into a user's Canadian calendar.

FAQs

Specific to using Canada Holidays API 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.