Provides access to Canadian public holiday data, allowing retrieval of all holidays (filterable by year, federal status, and optional provincial holidays), individual holiday details, and province or territory information, with a JSON schema endpoint for the API definition.
federal(query) — A boolean parameter. If true or 1, will return only federal holidays. If false or 0, will return no federal holidays.
optional(query) — A boolean parameter. If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.
GET
/api/v1/holidays/{holidayId}
Get a holiday by id
year(query) — A calendar year
optional(query) — 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.
GET
/api/v1/provinces
Get all provinces
year(query) — A calendar year
optional(query) — A boolean parameter. If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.
GET
/api/v1/provinces/{provinceId}
Get a province or territory by abbreviation
year(query) — A calendar year
optional(query) — A boolean parameter (AB and BC only). If false or 0 (default), will return only legislated holidays. If true or 1, will return optional holidays from Alberta and BC.
