Canada Holidays API
The Canada Holidays API lists public holidays for all 13 provinces and territories in Canada, including federal holidays.
https://canada-holidays.ca/api/v1/
Features
- Get all holidays with associated regions
- Get all regions with associated holidays
- Get federal holidays
- Get national holidays
- Get upcoming (“next”) holiday for each region
- Get holidays for past/future years:
2013, ⋯,2026, ⋯,2038.
Plus(!!!) check out all the goodies you get for free
- It’s free ()
- Dedicated support channel
- The site and the API are both bilingual (English and French)
- Basically compliant with Government of Canada Standards on APIs ()
- Open source which is cool if you’re a nerd
- Documented with an OpenAPI spec which is even cooler for even nerdier nerds
Definitely use it for your billions of dollars mission-critical system.
Documentation
There’s an OpenAPI spec at Canada-Holidays-API.v1.yaml and a SwaggerHub page where you can test the endpoints.
There’s also a basic overview on GitHub if you’re a “read-the-first-and-last-chapter” kind of person.
Citations
I’ve collected references to all the sources I’m using for each region in Canada, so data returned from the API should all be accurate.
Mistaeks do happen, however — lemme know if you spot any.
Back to top