258604868450

latestOpenAPI 3.0.0MIT2026-07-136320.5 KB
holidays

Get a holiday by id

Returns one Canadian statutory holiday by integer id. Returns a 404 response for invalid ids.

get/api/v1/holidays/{holidayId}

Query parameters

yearinteger

A calendar year

optional'1' | '0' | 'true' | 'false'

A boolean parameter. If false or 0 (default), will return provinces for which this is a legislated holiday. If true or 1, will return provinces which optionally celebrate this holiday.

Response

OK

Example response

{
  "holiday": {
    "id": 2,
    "date": "2020-12-26",
    "nameEn": "Louis Riel Day",
    "nameFr": "Journée Louis Riel",
    "observedDate": "2020-12-28",
    "provinces": [
      {
        "id": "MB",
        "nameFr": "Manitoba",
        "nameEn": "Manitoba",
        "sourceLink": "https://www.gov.mb.ca/labour/standards/doc,gen-holidays-after-april-30-07,factsheet.html#q12",
        "sourceEn": "What are the general holidays in Manitoba?"
      }
    ]
  }
}