Embark on a journey of global celebration with the Holidays API, your passport to comprehensive holiday information across 230+ countries, regions, and territories worldwide. This powerful API not only offers current data but also grants access to historical holiday records, allowing users to explore festivities from previous years. Whether you're planning ahead or curious about past revelries, the Holidays API has you covered.
Delving into its extensive dataset, users can discover a rich array of holidays, including public celebrations, diverse religious observances, and essential bank holidays. The API caters to various categories, ensuring a nuanced understanding of global festivities. Beyond merely providing dates, it offers contextual information, enabling developers to create applications that resonate with cultural and regional nuances.
The Holidays API is a dynamic tool for developers, businesses, and enthusiasts seeking to integrate accurate, up-to-date holiday information into their applications. Its versatility empowers users to enhance user experiences, plan events, or simply stay informed about cultural and religious observances worldwide. From vibrant public festivals to solemn religious ceremonies and the essential days when banks are closed, this API is your all-encompassing guide to global holidays, ensuring your applications are culturally attuned and globally relevant.
Returns a list of holiday entries for a given country and year. Each entry in the response contains the holiday name, date, day of the week, and the type of holiday.
Event Planning Applications: Event planning platforms can leverage the Holidays API to assist users in scheduling and organizing events worldwide. By incorporating accurate holiday data, these applications can help users avoid scheduling conflicts, ensuring seamless and well-timed gatherings.
Travel and Tourism Services: Travel apps can optimize user experiences by integrating the Holidays API to provide travelers with real-time information on holidays at their destination. This ensures that users are aware of local celebrations, allowing them to plan their trips around unique cultural events and festivities.
Workforce Management Systems: Human resource and workforce management systems can use the Holidays API to streamline employee scheduling. By factoring in public holidays and regional observances, these systems can automatically adjust work schedules, helping businesses maintain operational efficiency and comply with local labor laws.
Financial and Banking Applications: Banking and financial apps can benefit from the Holidays API to inform users about upcoming bank holidays. This ensures that customers are aware of non-working days, facilitating better financial planning and preventing potential inconveniences related to banking transactions.
Educational Tools and Platforms: Educational applications can incorporate the Holidays API to enhance global awareness in students. By including information on various cultural and religious observances, these tools can foster cross-cultural understanding and enrich students' knowledge of worldwide traditions, contributing to a more comprehensive and inclusive education.
Besides API call limitations per month, there is no other limitation.
Returns a list of holiday entries for a given country and year. Each entry in the response contains the holiday name, date, day of the week, and the type of holiday.
country
(required) - country name or ISO 3166-2 country code (preferred).
year
(required) - calendar year between 2010
and 2030
(inclusive). Note: not all countries are guarenteed contain data going back to 2010.
type
(optional) - holiday type filter. Possible values are:
major_holiday
- combination of public_holiday
, national_holiday
, and federal_holiday
.public_holiday
observance
national_holiday
federal_holiday
(US only)season
state_holiday
optional_holiday
clock_change_daylight_saving_time
local_holiday
united_nations_observance
observance_christian
bank_holiday
common_local_holiday
national_holiday_christian
christian
observance_hebrew
jewish_holiday
muslim
hindu_holiday
restricted_holiday
official_holiday
national_holiday_orthodox
local_observance
Object | Description |
---|---|
country |
[Required] country name or ISO 3166-2 country code (preferred). |
year |
[Required] calendar year between 2010 and 2030 (inclusive). |
type |
[Optional] holiday type filter |
[{"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-14", "day": "Sunday", "name": "Mother's Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-13", "day": "Monday", "name": "Commonwealth Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-10-31", "day": "Tuesday", "name": "Halloween", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-08-02", "day": "Wednesday", "name": "The Royal St John's Regatta (Regatta Day)", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-24", "day": "Monday", "name": "St. George's Day", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-03", "day": "Sunday", "name": "First Sunday of Advent", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-08-07", "day": "Monday", "name": "Heritage Day", "type": "OPTIONAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-07-27", "day": "Thursday", "name": "Tisha B'Av", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-09-30", "day": "Saturday", "name": "National Day for Truth and Reconciliation", "type": "FEDERAL_EMPLOYEES_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-07", "day": "Tuesday", "name": "Purim", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-24", "day": "Saturday", "name": "St. Jean Baptiste Day", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-08-18", "day": "Friday", "name": "Gold Cup Parade", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-08", "day": "Thursday", "name": "Corpus Christi", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-16", "day": "Sunday", "name": "Orthodox Easter", "type": "ORTHODOX"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-17", "day": "Monday", "name": "Orthodox Easter Monday", "type": "ORTHODOX"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-01-02", "day": "Monday", "name": "Day After New Year\u2019s Day", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-01-06", "day": "Friday", "name": "Epiphany", "type": "OBSERVANCE_CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-26", "day": "Tuesday", "name": "Boxing Day", "type": "STATUTORY_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-15", "day": "Saturday", "name": "Orthodox Holy Saturday", "type": "ORTHODOX"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-26", "day": "Wednesday", "name": "Yom HaAtzmaut", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-12", "day": "Sunday", "name": "Daylight Saving Time starts", "type": "CLOCK_CHANGE_DAYLIGHT_SAVING_TIME"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-17", "day": "Friday", "name": "St. Patrick's Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-22", "day": "Monday", "name": "Victoria Day", "type": "STATUTORY_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-02-20", "day": "Monday", "name": "Family Day", "type": "COMMON_LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-29", "day": "Monday", "name": "Whit Monday", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-11-08", "day": "Wednesday", "name": "National Aboriginal Veterans Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-08-15", "day": "Tuesday", "name": "Assumption of Mary", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-11-01", "day": "Wednesday", "name": "All Saints' Day", "type": "OBSERVANCE_CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-02", "day": "Sunday", "name": "Palm Sunday", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-26", "day": "Friday", "name": "Shavuot", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-10", "day": "Monday", "name": "Easter Monday", "type": "OPTIONAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-02-06", "day": "Monday", "name": "Tu B'Shevat (Arbor Day)", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-04", "day": "Sunday", "name": "Trinity Sunday", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-20", "day": "Monday", "name": "March Equinox", "type": "SEASON"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-01-14", "day": "Saturday", "name": "Orthodox New Year", "type": "ORTHODOX"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-07-01", "day": "Saturday", "name": "Canada Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-07-19", "day": "Wednesday", "name": "Muharram/Islamic New Year (Tentative Date)", "type": "MUSLIM"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-10-04", "day": "Wednesday", "name": "Feast of St Francis of Assisi", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-18", "day": "Thursday", "name": "Ascension Day", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-02-21", "day": "Tuesday", "name": "Carnival / Shrove Tuesday", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-11-05", "day": "Sunday", "name": "Daylight Saving Time ends", "type": "CLOCK_CHANGE_DAYLIGHT_SAVING_TIME"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-09-23", "day": "Saturday", "name": "September Equinox", "type": "SEASON"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-10-07", "day": "Saturday", "name": "Shemini Atzeret", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-13", "day": "Thursday", "name": "Last day of Passover", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-07-10", "day": "Monday", "name": "Orangemen's Day", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-25", "day": "Monday", "name": "Christmas Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-09-04", "day": "Monday", "name": "Labour Day", "type": "PUBLIC_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-07-28", "day": "Friday", "name": "Ashura (Tentative Date)", "type": "MUSLIM"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-08", "day": "Saturday", "name": "Holy Saturday", "type": "CHRISTIAN"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-18", "day": "Sunday", "name": "Father's Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-03-01", "day": "Wednesday", "name": "St David's Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-31", "day": "Sunday", "name": "New Year's Eve", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-26", "day": "Monday", "name": "June Holiday", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-22", "day": "Saturday", "name": "Eid ul Fitr", "type": "MUSLIM"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-06", "day": "Thursday", "name": "Tartan Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-02-02", "day": "Thursday", "name": "Groundhog Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-14", "day": "Friday", "name": "Orthodox Good Friday", "type": "ORTHODOX"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-02-15", "day": "Wednesday", "name": "National Flag of Canada Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-08-21", "day": "Monday", "name": "Discovery Day", "type": "LOCAL_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-11-12", "day": "Sunday", "name": "Diwali/Deepavali", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-09-25", "day": "Monday", "name": "Yom Kippur", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-05-09", "day": "Tuesday", "name": "Lag B'Omer", "type": "JEWISH_HOLIDAY"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-01-22", "day": "Sunday", "name": "Chinese New Year", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-11-11", "day": "Saturday", "name": "Remembrance Day", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-09-27", "day": "Wednesday", "name": "Milad un Nabi (Mawlid) (Tentative Date)", "type": "MUSLIM"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-24", "day": "Sunday", "name": "Christmas Eve", "type": "OBSERVANCE"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-12-21", "day": "Thursday", "name": "December Solstice", "type": "SEASON"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-04-18", "day": "Tuesday", "name": "Yom HaShoah", "type": "JEWISH_COMMEMORATION"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-21", "day": "Wednesday", "name": "June Solstice", "type": "SEASON"}, {"country": "Canada", "iso": "CA", "year": 2023, "date": "2023-06-29", "day": "Thursday", "name": "Eid ul Adha", "type": "MU...
curl --location --request GET 'https://zylalabs.com/api/3211/holidays+api/3434/get+holidays?country=CA&year=2023&type=public_holiday' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Holidays API REST API, simply include your bearer token in the Authorization header.
Header | Description |
---|---|
Authorization
|
[Required] Should be Bearer access_key . See "Your API Access Key" above when you are subscribed. |
No long term commitments. One click upgrade/downgrade or cancellation. No questions asked.
The Holidays API covers over 230 countries, regions, and territories globally, offering comprehensive holiday data for a wide range of locations.
Yes, the API allows users to access historical holiday data, enabling them to explore and analyze festivities from previous years.
The API is regularly updated to ensure accuracy and relevance. Updates typically occur in real-time for current holiday information, and historical data is maintained with periodic updates.
The Holidays API encompasses various categories, including public holidays, religious observances, and bank holidays, providing a nuanced understanding of diverse celebrations worldwide.
Users can access holiday calendars for future years, allowing for advanced planning and scheduling in applications.
Zyla API Hub is, in other words, an API MarketPlace. An all-in-one solution for your developing needs. You will be accessing our extended list of APIs with only your user. Also, you won't need to worry about storing API keys, only one API key for all our products is needed.
Prices are listed in USD. We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the worldβs most reliable payment companies. If you have any trouble with paying by card, just contact us at [email protected]
Sometimes depending on the bank's fraud protection settings, a bank will decline the validation charge we make when we attempt to be sure a card is valid. We recommend first contacting your bank to see if they are blocking our charges. If more help is needed, please contact [email protected] and our team will investigate further
Prices are based on a recurring monthly subscription depending on the plan selected β plus overage fees applied when a developer exceeds a planβs quota limits. In this example, you'll see the base plan amount as well as a quota limit of API requests. Be sure to notice the overage fee because you will be charged for each additional request.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
Just go to the pricing page of that API and select the plan that you want to upgrade to. You will only be charged the full amount of that plan, but you will be enjoying the features that the plan offers right away.
Yes, absolutely. If you want to cancel your plan, simply go to your account and cancel on the Billing page. Upgrades, downgrades, and cancellations are immediate.
You can contact us through our chat channel to receive immediate assistance. We are always online from 9 am to 6 pm (GMT+1). If you reach us after that time, we will be in contact when we are back. Also you can contact us via email to [email protected]
Service Level:
100%
Response Time:
228ms
Service Level:
50%
Response Time:
923ms
Service Level:
75%
Response Time:
1,745ms
Service Level:
100%
Response Time:
228ms
Service Level:
100%
Response Time:
1,629ms
Service Level:
100%
Response Time:
180ms
Service Level:
100%
Response Time:
5,954ms
Service Level:
100%
Response Time:
165ms
Service Level:
100%
Response Time:
412ms
Service Level:
100%
Response Time:
693ms
Service Level:
100%
Response Time:
890ms
Service Level:
100%
Response Time:
1,101ms
Service Level:
100%
Response Time:
408ms
Service Level:
100%
Response Time:
8,176ms
Service Level:
100%
Response Time:
595ms
Service Level:
100%
Response Time:
3,051ms
Service Level:
100%
Response Time:
2,841ms