The Canada Holidays API is a useful tool for developers looking to incorporate accurate holiday information into their applications or systems. With this API, developers can access a comprehensive list of all 31 public holidays across Canada, including federal holidays.
The API provides holiday information for all 13 provinces and territories in Canada, making it a convenient resource for developers who need to display holiday information specific to a particular region or province. The holiday information is updated regularly to ensure that developers have access to the most accurate and up-to-date information.
By incorporating the Canada Holidays API into their applications or systems, developers can provide their users with important information about upcoming holidays, helping them to plan and schedule their activities more effectively. This information can be particularly useful for businesses that need to schedule staff or plan events around public holidays.
The Canada Holidays API is easy to use and can be integrated into a variety of applications and systems. Developers can access the API using a simple RESTful interface, and the API provides responses in JSON format, making it easy to integrate with a variety of programming languages and platforms.
In addition to providing holiday information, the Canada Holidays API also includes details about the history and significance of each holiday, as well as any relevant customs or traditions associated with the holiday. This information can be a valuable resource for developers who want to provide their users with a deeper understanding of Canadian culture and history.
Overall, the Canada Holidays API is an essential resource for developers who need to incorporate accurate holiday information into their applications or systems. With its comprehensive list of public holidays across Canada and easy-to-use interface, the Canada Holidays API makes it easy to provide users with the information they need to plan and schedule their activities effectively.
Receive a list of all the Canadian holidays.
Employee scheduling: Many businesses need to schedule their employees around public holidays, and the Canada Holidays API can be a useful tool for automating this process. By integrating the API into their scheduling software, businesses can ensure that they are scheduling their employees appropriately for public holidays across all provinces and territories.
Travel planning: People planning a trip to Canada from another country may not be familiar with Canadian public holidays. By incorporating the Canada Holidays API into a travel planning app or website, developers can ensure that users are aware of upcoming public holidays that may impact their travel plans.
Sales and promotions: Retailers may want to schedule sales or promotions around public holidays to take advantage of increased shopping activity. By using the Canada Holidays API to display public holiday information, retailers can ensure that they are scheduling their promotions appropriately across all provinces and territories.
Event planning: Event planners may need to schedule events around public holidays to ensure maximum attendance. By integrating the Canada Holidays API into their event planning software, planners can ensure that they are scheduling events appropriately across all provinces and territories.
Cultural education: Schools and other educational institutions may want to incorporate information about Canadian culture and history into their curriculum. By using the Canada Holidays API to provide details about the history and significance of each public holiday, educators can provide students with a deeper understanding of Canadian culture and history.
Besides the number of API calls, there are no other limitations.
Returns Canadian public holidays. Each holiday lists the regions that observe it.
Get Holidays - Endpoint Features
| Object | Description |
|---|---|
federal |
[Required] A boolean parameter. If true or 1, will return only federal holidays. If false or 0, will return no federal holidays. |
year |
[Required] Default: 2023 Minimum: 2016 Maximum: 2029 |
{"holidays":[{"id":1,"date":"2023-01-01","nameEn":"New Year’s Day","nameFr":"Jour de l’An","federal":1,"observedDate":"2023-01-02","provinces":[{"id":"AB","nameEn":"Alberta","nameFr":"Alberta","sourceLink":"https://www.alberta.ca/alberta-general-holidays.aspx#jumplinks-1","sourceEn":"General holidays in Alberta"},{"id":"BC","nameEn":"British Columbia","nameFr":"Colombie-Britannique","sourceLink":"https://www2.gov.bc.ca/gov/content/employment-business/employment-standards-advice/employment-standards/statutory-holidays#body","sourceEn":"Statutory Holidays in British Columbia"},{"id":"MB","nameEn":"Manitoba","nameFr":"Manitoba","sourceLink":"https://www.gov.mb.ca/labour/standards/doc,gen-holidays-after-april-30-07,factsheet.html#q12","sourceEn":"General holidays in Manitoba"},{"id":"NB","nameEn":"New Brunswick","nameFr":"Nouveau-Brunswick","sourceLink":"https://www2.gnb.ca/content/gnb/en/departments/elg/local_government/content/governance/content/days_of_rest_act/faq.html#2","sourceEn":"10 prescribed days of rest"},{"id":"NL","nameEn":"Newfoundland and Labrador","nameFr":"Terre-Neuve-et-Labrador","sourceLink":"https://gist.github.com/pcraig3/81dff348ddf52777c9f918c3032531bd","sourceEn":"Public holidays in Newfoundland"},{"id":"NT","nameEn":"Northwest Territories","nameFr":"Territoires du Nord-Ouest","sourceLink":"https://www.ece.gov.nt.ca/en/services/employment-standards/frequently-asked-questions#Statutory%20Holidays","sourceEn":"Employment Standards, Northwest Territories"},{"id":"NS","nameEn":"Nova Scotia","nameFr":"Nouvelle-Écosse","sourceLink":"https://novascotia.ca/lae/employmentrights/holidaychart.asp","sourceEn":"Paid holidays in Nova Scotia"},{"id":"NU","nameEn":"Nunavut","nameFr":"Nunavut","sourceLink":"https://nu-lsco.ca/faq-s?tmpl=component&faqid=11","sourceEn":"Nunavut General Holidays"},{"id":"ON","nameEn":"Ontario","nameFr":"Ontario","sourceLink":"https://www.ontario.ca/document/your-guide-employment-standards-act-0/public-holidays","sourceEn":"Ontario Public holidays"},{"id":"PE","nameEn":"Prince Edward Island","nameFr":"Île-du-Prince-Édouard","sourceLink":"https://www.princeedwardisland.ca/en/information/economic-growth-tourism-and-culture/paid-holidays","sourceEn":"PEI Paid Holidays"},{"id":"QC","nameEn":"Quebec","nameFr":"Québec","sourceLink":"https://www2.gouv.qc.ca/entreprises/portail/quebec/ressourcesh?lang=fr&g=ressourcesh&sg=personnel&t=o&e=2318829344:3908165687","sourceEn":"Jours fériés, chômés et payés"},{"id":"SK","nameEn":"Saskatchewan","nameFr":"Saskatchewan","sourceLink":"https://www.saskatchewan.ca/business/employment-standards/public-statutory-holidays/list-of-saskatchewan-public-holidays","sourceEn":"Saskatchewan Public Holidays"},{"id":"YT","nameEn":"Yukon","nameFr":"Yukon","sourceLink":"https://yukon.ca/en/doing-business/employer-responsibilities/find-yukon-statutory-holiday","sourceEn":"Yukon statutory holiday dates"}]},{"id":7,"date":"2023-04-07","nameEn":"Good Friday","nameFr":"Vendredi saint","federal":1,"observedDate":"2023-04-07","provinces":[{"id":"AB","nameEn":"Alberta","nameFr":"Alberta","sourceLink":"https://www.alberta.ca/alberta-general-holidays.aspx#jumplinks-1","sourceEn":"General holidays in Alberta"},{"id":"BC","nameEn":"British Columbia","nameFr":"Colombie-Britannique","sourceLink":"https://www2.gov.bc.ca/gov/content/employment-business/employment-standards-advice/employment-standards/statutory-holidays#body","sourceEn":"Statutory Holidays in British Columbia"},{"id":"MB","nameEn":"Manitoba","nameFr":"Manitoba","sourceLink":"https://www.gov.mb.ca/labour/standards/doc,gen-holidays-after-april-30-07,factsheet.html#q12","sourceEn":"General holidays in Manitoba"},{"id":"NB","nameEn":"New Brunswick","nameFr":"Nouveau-Brunswick","sourceLink":"https://www2.gnb.ca/content/gnb/en/departments/elg/local_government/content/governance/content/days_of_rest_act/faq.html#2","sourceEn":"10 prescribed days of rest"},{"id":"NL","nameEn":"Newfoundland and Labrador","nameFr":"Terre-Neuve-et-Labrador","sourceLink":"https://gist.github.com/pcraig3/81dff348ddf52777c9f918c3032531bd","sourceEn":"Public holidays in Newfoundland"},{"id":"NT","nameEn":"Northwest Territories","nameFr":"Territoires du Nord-Ouest","sourceLink":"https://www.ece.gov.nt.ca/en/services/employment-standards/frequently-asked-questions#Statutory%20Holidays","sourceEn":"Employment Standards, Northwest Territories"},{"id":"NS","nameEn":"Nova Scotia","nameFr":"Nouvelle-Écosse","sourceLink":"https://novascotia.ca/lae/employmentrights/holidaychart.asp","sourceEn":"Paid holidays in Nova Scotia"},{"id":"NU","nameEn":"Nunavut","nameFr":"Nunavut","sourceLink":"https://nu-lsco.ca/faq-s?tmpl=component&faqid=11","sourceEn":"Nunavut General Holidays"},{"id":"ON","nameEn":"Ontario","nameFr":"Ontario","sourceLink":"https://www.ontario.ca/document/your-guide-employment-standards-act-0/public-holidays","sourceEn":"Ontario Public holidays"},{"id":"PE","nameEn":"Prince Edward Island","nameFr":"Île-du-Prince-Édouard","sourceLink":"https://www.princeedwardisland.ca/en/information/economic-growth-tourism-and-culture/paid-holidays","sourceEn":"PEI Paid Holidays"},{"id":"QC","nameEn":"Quebec","nameFr":"Québec","sourceLink":"https://www2.gouv.qc.ca/entreprises/portail/quebec/ressourcesh?lang=fr&g=ressourcesh&sg=personnel&t=o&e=2318829344:3908165687","sourceEn":"Jours fériés, chômés et payés"},{"id":"SK","nameEn":"Saskatchewan","nameFr":"Saskatchewan","sourceLink":"https://www.saskatchewan.ca/business/employment-standards/public-statutory-holidays/list-of-saskatchewan-public-holidays","sourceEn":"Saskatchewan Public Holidays"},{"id":"YT","nameEn":"Yukon","nameFr":"Yukon","sourceLink":"https://yukon.ca/en/doing-business/employer-responsibilities/find-yukon-statutory-holiday","sourceEn":"Yukon statutory holiday dates"}]},{"id":8,"date":"2023-04-10","nameEn":"Easter Monday","nameFr":"Lundi de Pâques","federal":1,"observedDate":"2023-04-10","provinces":[]},{"id":11,"date":"2023-05-22","nameEn":"Victoria Day","nameFr":"Fête de la Reine","federal":1,"observedDate":"2023-05-22","provinces":[{"id":"AB","nameEn":"Alberta","nameFr":"Alberta","sourceLink":"https://www.alberta.ca/alberta-general-holidays.aspx#jumplinks-1","sourceEn":"General holidays in Alberta"},{"id":"BC","nameEn":"British Columbia","nameFr":"Colombie-Britannique","sourceLink":"https://www2.gov.bc.ca/gov/content/employment-business/employment-standards-advice/employment-standards/statutory-holidays#body","sourceEn":"Statutory Holidays in British Columbia"},{"id":"MB","nameEn":"Manitoba","nameFr":"Manitoba","sourceLink":"https://www.gov.mb.ca/labour/standards/doc,gen-holidays-after-april-30-07,factsheet.html#q12","sourceEn":"General holidays in Manitoba"},{"id":"NT","nameEn":"Northwest Territories","nameFr":"Territoires du Nord-Ouest","sourceLink":"https://www.ece.gov.nt.ca/en/services/employment-standards/frequently-asked-questions#Statutory%20Holidays","sourceEn":"Employment Standards, Northwest Territories"},{"id":"NU","nameEn":"Nunavut","nameFr":"Nunavut","sourceLink":"https://nu-lsco.ca/faq-s?tmpl=component&faqid=11","sourceEn":"Nunavut General Holidays"},{"id":"ON","nameEn":"Ontario","nameFr":"Ontario","sourceLink":"https://www.ontario.ca/document/your-guide-employment-standards-act-0/public-holidays","sourceEn":"Ontario Public holidays"},{"id":"SK","nameEn":"Saskatchewan","nameFr":"Saskatchewan","sourceLink":"https://www.saskatchewan.ca/business/employment-standards/public-statutory-holidays/list-of-saskatchewan-public-holidays","sourceEn":"Saskatchewan Public Holidays"},{"id":"YT","nameEn":"Yukon","nameFr":"Yukon","sourceLink":"https://yukon.ca/en/doing-business/employer-responsibilities/find-yukon-statutory-holiday","sourceEn":"Yukon statutory holiday dates"}]},{"id":15,"date":"2023-07-01","nameEn":"Canada Day","nameFr":"Fête du Canada","federal":1,"observedDate":"2023-07-03","provinces":[{"id":"AB","nameEn":"Alberta","nameFr":"Alberta","sourceLink":"https://www.alberta.ca/alberta-general-holidays.aspx#jumplinks-1","sourceEn":"General holidays in Alberta"},{"id":"BC","nameEn":"British Columbia","nameFr":"Colombie-Britannique","sourceLink":"https://www2.gov.bc.ca/gov/content/employment-business/employment-standards-advice/employment-standards/statutory-holidays#body","sourceEn":"Statutory Holidays in British Columbia"},{"id":"MB","nameEn":"Manitoba","nameFr":"Manitoba","sourceLink":"https://www.gov.mb.ca/labour/standards/doc,gen-holidays-after-april-30-07,factsheet.html#q12","sourceEn":"General holidays in Manitoba"},{"id":"NB","nameEn":"New Brunswick","nameFr":"Nouveau-Brunswick","sourceLink":"https://www2.gnb.ca/content/gnb/en/departments/elg/local_government/content/governance/content/days_of_rest_act/faq.html#2","sourceEn":"10 prescribed days of rest"},{"id":"NL","nameEn":"Newfoundland and Labrador","nameFr":"Terre-Neuve-et-Labrador","sourceLink":"https://gist.github.com/pcraig3/81dff348ddf52777c9f918c3032531bd","sourceEn":"Public holidays in Newfoundland"},{"id":"NT","nameEn":"Northwest Territories","nameFr":"Territoires du Nord-Ouest","sourceLink":"https://www.ece.gov.nt.ca/en/services/employment-standards/frequently-asked-questions#Statutory%20Holidays","sourceEn":"Employment Standards, Northwest Territories"},{"id":"NS","nameEn":"Nova Scotia","nameFr":"Nouvelle-Écosse","sourceLink":"https://novascotia.ca/lae/employmentrights/holidaychart.asp","sourceEn":"Paid holidays in Nova Scotia"},{"id":"NU","nameEn":"Nunavut","nameFr":"Nunavut","sourceLink":"https://nu-lsco.ca/faq-s?tmpl=component&faqid=11","sourceEn":"Nunavut General Holidays"},{"id":"ON","nameEn":"Ontario","nameFr":"Ontario","sourceLink":"https://www.ontario.ca/document/your-guide-employment-standards-act-0/public-holidays","sourceEn":"Ontario Public holidays"},{"id":"PE","nameEn":"Prince Edward Island","nameFr":"Île-du-Prince-Édouard","sourceLink":"https://www.princeedwardisland.ca/en/information/economic-growth-tourism-and-culture/paid-holidays","sourceEn":"PEI Paid Holidays"}]}],"_note":"Response truncated for documentation purposes"}
curl --location --request GET 'https://zylalabs.com/api/1996/canada+holidays+api/1763/get+holidays?federal=1&year=2023' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
The Canada Holidays API returns a comprehensive list of public holidays across Canada, including federal holidays. Each holiday entry includes details such as the date, name in English and French, observed date, and the provinces that recognize the holiday.
Key fields in the response data include "id" (holiday identifier), "date" (holiday date), "nameEn" (holiday name in English), "nameFr" (holiday name in French), "federal" (indicating if it's a federal holiday), "observedDate" (date observed), and "provinces" (list of provinces observing the holiday).
The response data is organized in a JSON format, with a main object containing a "holidays" array. Each holiday object within the array includes various attributes such as date, names, and associated provinces, making it easy to parse and utilize in applications.
The endpoint provides information on public holidays, including their dates, names in both English and French, observed dates, and the provinces and territories that recognize each holiday, along with links to official sources for further details.
The data covers all 13 provinces and territories in Canada, providing a complete overview of public holidays, including both federal and regional holidays, ensuring comprehensive coverage for developers needing localized holiday information.
Users can customize their data requests by specifying parameters such as the desired province or territory to filter holidays relevant to a specific region. This allows for tailored responses based on user needs.
The data is sourced from official government websites and resources related to public holidays in Canada. This ensures that the information is accurate, reliable, and reflects the latest holiday designations and observances.
Typical use cases include employee scheduling, travel planning, event planning, and cultural education. Businesses can automate scheduling around holidays, while travelers can plan trips considering public holidays that may affect their plans.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
451ms
Service Level:
100%
Response Time:
304ms
Service Level:
100%
Response Time:
289ms
Service Level:
100%
Response Time:
9,558ms
Service Level:
100%
Response Time:
676ms
Service Level:
100%
Response Time:
670ms
Service Level:
100%
Response Time:
1,949ms
Service Level:
100%
Response Time:
1,165ms
Service Level:
75%
Response Time:
295ms
Service Level:
100%
Response Time:
268ms
Service Level:
100%
Response Time:
3,750ms
Service Level:
100%
Response Time:
369ms
Service Level:
100%
Response Time:
32ms
Service Level:
100%
Response Time:
44ms
Service Level:
100%
Response Time:
50ms
Service Level:
100%
Response Time:
30ms
Service Level:
100%
Response Time:
658ms
Service Level:
100%
Response Time:
48ms
Service Level:
100%
Response Time:
66ms
Service Level:
100%
Response Time:
46ms
