# Canadian Statutory Holidays by Province

> Canadian Statutory Holidays by Province is a paid API for AI agents from ca-tax-api-mainnet.lxtap.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-23).

Returns the list of statutory (public) holidays for a specified Canadian province or territory in a given year, including local names, exact dates, and observed weekday adjustments for weekend-falling holidays.

## Facts

- Endpoint: GET https://ca-tax-api-mainnet.lxtap.workers.dev/holidays?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/canadian-statutory-holidays-by-province-ed833ac9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_a84Fkn9CrSWbbVesyuf8w

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability canadian-statutory-holidays-by-province-ed833ac9
```

Example prompt: Can you list all the statutory holidays in Ontario for 2025, including the actual dates they're observed if any fall on a weekend?

## When to prefer this

Use this endpoint when you need authoritative, province-specific Canadian statutory holiday data with correct local naming conventions and weekend-shift observance rules — especially when building payroll, HR, legal, or scheduling systems that must comply with Canadian provincial labour standards. Prefer this over generic calendar APIs that may not reflect province-level holiday variations or use official local holiday names.

## Known failure modes

- Invalid province code returns an error — must be one of the 13 supported two-letter codes (AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT)
- Year outside the 2000–2100 range is rejected by schema validation
- Missing required query parameters (province or year) results in a 400-style error
- Network or worker-side failures may return 5xx errors

## How this service works

Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.

## Output

A structured list of statutory holidays for the requested Canadian province/territory and year, each entry including the holiday's local name, its calendar date, the weekday it falls on, and (where applicable) the observed date when the holiday shifts due to falling on a Saturday or Sunday.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "province",
      "year"
     ],
     "properties": {
      "year": {
       "type": "string",
       "pattern": "^\\d{4}$",
       "description": "Year from 2000 to 2100"
      },
      "province": {
       "enum": [
        "AB",
        "BC",
        "MB",
        "NB",
        "NL",
        "NS",
        "NT",
        "NU",
        "ON",
        "PE",
        "QC",
        "SK",
        "YT"
       ],
       "type": "string",
       "description": "Two-letter Canadian province or territory code"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2027,
  "holidays": [
   {
    "date": "2027-01-01",
    "name": "New Year's Day",
    "observed": "2027-01-01"
   },
   {
    "date": "2027-06-24",
    "name": "Saint-Jean-Baptiste Day",
    "observed": "2027-06-24"
   }
  ],
  "province": "QC"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/canadian-statutory-holidays-by-province-ed833ac9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ca-tax-api-mainnet.lxtap.workers.dev](https://www.zero.xyz/host/ca-tax-api-mainnet.lxtap.workers.dev/llms.txt)