About the API:
This API retrieves a list of all public and non-public holidays that are celebrated in a specific country. Check for the current year, future years, and previous ones as well. Supporting 195 countries worldwide.
Just pass the country of your choice, select the year, and even the month and day that you want to check.
You will receive the holiday's date, its name if it's public or not, and on which day of the week it will be celebrated.
List of supported countries:
AD (Andorra)
AE (دولة الإمارات العربية المتحدة)
AG (Antigua & Barbuda)
AI (Anguilla)
AL (Shqipëri)
AM (Հայաստան)
AO (Angola)
AR (Argentina)
AS (American Samoa)
AT (Österreich)
AU (Australia)
AW (Aruba)
AX (Landskapet Åland)
AZ (Azərbaycan Respublikası)
BA (Bosna i Hercegovina)
BB (Barbados)
BD (গণপ্রজাতন্ত্রী বাংলাদেশ)
BE (Belgique)
BF (Burkina Faso)
BG (България)
BH (مملكة البحرين)
BI (République du Burundi)
BJ (République du Bénin)
BL (St. Barthélemy)
BM (Bermuda)
BN (Negara Brunei Darussalam)
BO (Bolivia)
BQ (Caribisch Nederland)
BR (Brasil)
BS (Bahamas)
BW (Botswana)
BY (Рэспубліка Беларусь)
BZ (Belize)
CA (Canada)
CC (Cocos (Keeling) Islands)
CD (République démocratique du Congo)
CF (République centrafricaine)
CG (République du Congo)
CH (Schweiz)
CI (République de Côte d'Ivoire)
CK (Cook Islands)
CL (Chile)
CM (Cameroun)
CN (中华人民共和国)
CO (Colombia)
CR (Costa Rica)
CU (Cuba)
CV (República de Cabo Verde)
CW (Curaçao)
CX (Christmas Island)
CY (Κύπρος)
CZ (Česká republika)
DE (Deutschland)
DJ (République de Djibouti)
DK (Danmark)
DM (Dominica)
DO (República Dominicana)
DZ (الجمهورية الجزائرية الديمقراطية الشعبية)
EC (Ecuador)
EE (Eesti)
EG (جمهورية مصر العربية)
EH (الجمهورية العربية الصحراوية الديمقراطية)
ER (Eritrea)
ES (España)
ET (ኢትዮጵያ)
FI (Suomi)
FJ (Matanitu Tugalala o Viti)
FO (Føroyar)
FR (France)
GA (Gabon)
GB (United Kingdom)
GD (Grenada)
GE (საქართველო)
GF (Guyane)
GG (Guernsey)
GH (Ghana)
GI (Gibraltar)
GL (Kalaallit Nunaat)
GM (The Gambia)
GN (Guinée)
GP (Guadeloupe)
GQ (República de Guinea Ecuatorial)
GR (Ελλάδα)
GT (Guatemala)
GU (Guam)
GW (Guiné-Bissau)
GY (Guyana)
HK (香港)
HN (Honduras)
HR (Hrvatska)
HT (Haïti)
HU (Magyarország)
IC (Islas Canarias)
ID (Indonesia)
IE (Ireland)
IL (מְדִינַת יִשְׂרָאֵל)
IM (Isle of Man)
IS (Ísland)
IT (Italia)
JE (Jersey)
JM (Jamaica)
JP (日本)
KE (Kenya)
KM (Union des Comores)
KN (St. Kitts & Nevis)
KR (대한민국)
KY (Cayman Islands)
LC (St. Lucia)
LI (Lichtenstein)
LR (Liberia)
LS: (Muso oa Lesotho)
LT (Lietuva)
LU (Luxembourg)
LV (Latvija)
LY (دولة ليبيا)
MA (المملكة المغربية)
MC (Monaco)
MD (Republica Moldova)
ME (Crna Gora)
MF (Saint Martin)
MG (Repoblikan'i Madagasikara)
MK (Република Македонија)
ML (République du Mali)
MQ (Martinique)
MR (الجمهورية الإسلامية الموريتانية)
MS (Montserrat)
MT (Malta)
MW (Malawi)
MX (México)
MY (Malaysia)
MZ (Moçambique)
NA (Namibia)
NC (Nouvelle-Calédonie)
NE (République du Niger)
NG (Nigeria)
NI (Nicaragua)
NL (Nederland)
NO (Norge)
NZ (New Zealand)
PA (Panamá)
PE (Perú)
PH (Philippines)
PL (Polska)
PM (St. Pierre & Miquelon)
PR (Puerto Rico)
PT (Portugal)
PY (Paraguay)
RE (Réunion)
RO (Romania)
RS (Република Србија)
RU (Россия)
RW (Rwanda)
SC (Seychelles)
SD (جمهورية السودان)
SE (Sverige)
SG (Singapore)
SH (St. Helena)
SI (Republika Slovenija)
SJ (Svalbard & Jan Mayen)
SK (Slovenská republika)
SL (Sierra Leone)
SM (San Marino)
SN (République du Sénégal)
SO (Jamhuuriyadda Federaalka Soomaaliya)
SR (Suriname)
SS (South Sudan)
ST (São Tomé & Príncipe)
SV (El Salvador)
SX (Sint Maarten)
SZ (Eswatini)
TC (Turks & Caicos Islands)
TD (جمهورية تشاد)
TG (République togolaise)
TN (الجمهورية التونسية)
TO (Puleʻanga Fakatuʻi ʻo Tonga)
TR (Türkiye)
TT (Trinidad & Tobago)
TW (中華民國)
TZ (Tanzania)
UA (Україна)
UG (Uganda)
US (United States of America)
UY (Uruguay)
VA (Stato della Città del Vaticano)
VC (St. Vincent & Grenadines)
VE (Venezuela)
VG (British Virgin Islands)
VI (U.S. Virgin Islands)
VN (Cộng hòa Xã hội chủ nghĩa Việt Nam)
VU (République de Vanuatu)
XK (Republika e Kosovës)
YT (Mayotte)
ZA (South Africa)
ZM (Zambia)
ZW (Zimbabwe)
This API is ideal for those who want to keep track of any holiday in the country of their desire. You will be able to detect how many workable days the year will have and take decisions based on that information.
If you are a travel agency and want to provide special offers based on a specific holiday, you can achieve that with this API.
Recognize where the holiday will be taking place, so you will know if it's a workable day or a weekend day.
Besides the number of API calls per month:
Free Plan: 1 request per second.
Basic Plan: 100 requests per second.
To use this endpoint just run it and you will get all available countries.
{"message":"Available Countries","total":233,"countriesAvailable":["afghanistan","albania","algeria","american-samoa","andorra","angola","anguilla","antigua-and-barbuda","argentina","armenia","aruba","australia","austria","azerbaijan","bahrain","bangladesh","barbados","belarus","belgium","belize","benin","bermuda","bhutan","bolivia","bosnia","botswana","brazil","british-virgin-islands","brunei","bulgaria","burkina-faso","burundi","cape-verde","cambodia","cameroon","canada","cayman-islands","central-african-republic","chad","chile","china","colombia","comores","republic-of-the-congo","dr-congo","cook-islands","costa-rica","ivory-coast","croatia","cuba","curacao","cyprus","czech","denmark","djibouti","dominica","dominican-republic","timor-leste","ecuador","egypt","el-salvador","guineaecuatorial","eritrea","estonia","eswatini","ethiopia","falkland-islands","faroe-islands","fiji","finland","france","french-guiana","french-polynesia","gabon","gambia","georgia","germany","ghana","gibraltar","greece","greenland","grenada","guadeloupe","guam","guatemala","guernsey","guinea","guinea-bissau","guyana","haiti","honduras","hong-kong","hungary","iceland","india","indonesia","iran","iraq","ireland","isle-of-man","israel","italy","jamaica","japan","jersey","jordan","kazakhstan","kenya","kiribati","kosovo","kuwait","kyrgyzstan","laos","latvia","lebanon","lesotho","liberia","libya","liechtenstein","lithuania","luxembourg","macau","madagascar","malawi","malaysia","maldives","mali","malta","marshall-islands","martinique","mauritania","mauritius","mayotte","mexico","micronesia","moldova","monaco","mongolia","montenegro","montserrat","morocco","mozambique","myanmar","namibia","nauru","nepal","netherlands","new-caledonia","new-zealand","nicaragua","niger","nigeria","norfolk-island","north-korea","macedonia","northern-mariana-islands","norway","oman","pakistan","palau","panama","papua-new-guinea","paraguay","peru","philippines","poland","portugal","puerto-rico","qatar","reunion","romania","russia","rwanda","saint-helena","saint-kitts-and-nevis","saint-lucia","saint-martin","saint-pierre-and-miquelon","saint-vincent-and-the-grenadines","samoa","san-marino","sao-tome-and-principe","saudi-arabia","senegal","serbia","seychelles","sierra-leone","singapore","sint-maarten","slovakia","slovenia","solomon-islands","somalia","south-africa","south-korea","south-sudan","spain","sri-lanka","saint-barthelemy","sudan","suriname","sweden","switzerland","syria","taiwan","tajikistan","tanzania","thailand","bahamas","togo","tonga","trinidad","tunisia","turkey","turkmenistan","turks-and-caicos-islands","tuvalu","uganda","ukraine","united-arab-emirates","uk","us","uruguay","united-states-virgin-islands","uzbekistan","vanuatu","vatican-city-state","venezuela","vietnam","wallis-and-futuna","yemen","zambia","zimbabwe"]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7772/available+countries' --header 'Authorization: Bearer YOUR_API_KEY'
To use this endpoint you must enter a country name and a year (optional).
Holidays by Country - Endpoint Features
| Object | Description |
|---|---|
country |
[Required] Indicates a country name |
year |
Optional Indicates a year |
{"country":"denmark","year":2024,"holidays":[{"date":"Jan 1 - Monday","name":"New Year's Day","type":"National Holiday","details":""},{"date":"Jan 14 - Sunday","name":"Accession of King Frederik X","type":"Observance","details":""},{"date":"Feb 11 - Sunday","name":"Carnival","type":"Observance","details":""},{"date":"Feb 14 - Wednesday","name":"Valentine's Day","type":"Observance","details":""},{"date":"Mar 20 - Wednesday","name":"March Equinox","type":"Season","details":""},{"date":"Mar 24 - Sunday","name":"Palm Sunday","type":"Observance","details":""},{"date":"Mar 28 - Thursday","name":"Maundy Thursday","type":"National Holiday","details":""},{"date":"Mar 29 - Friday","name":"Good Friday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Easter Sunday","type":"National Holiday","details":""},{"date":"Mar 31 - Sunday","name":"Daylight Saving Time starts","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Apr 1 - Monday","name":"Easter Monday","type":"National Holiday","details":""},{"date":"Apr 26 - Friday","name":"Great Prayer Day","type":"Observance","details":""},{"date":"May 1 - Wednesday","name":"Labor Day / May Day","type":"Private Sector Holiday","details":""},{"date":"May 5 - Sunday","name":"Liberation Day","type":"Observance","details":""},{"date":"May 9 - Thursday","name":"Ascension Day","type":"National Holiday","details":""},{"date":"May 12 - Sunday","name":"Mother’s Day","type":"Observance","details":""},{"date":"May 19 - Sunday","name":"Whit Sunday","type":"National Holiday","details":""},{"date":"May 20 - Monday","name":"Whit Monday","type":"National Holiday","details":""},{"date":"Jun 5 - Wednesday","name":"Father’s Day","type":"Observance","details":""},{"date":"Jun 5 - Wednesday","name":"Constitution Day","type":"Private Sector Holiday","details":""},{"date":"Jun 20 - Thursday","name":"June Solstice","type":"Season","details":""},{"date":"Sep 22 - Sunday","name":"September Equinox","type":"Season","details":""},{"date":"Oct 27 - Sunday","name":"Daylight Saving Time ends","type":"Clock Change/Daylight Saving Time","details":""},{"date":"Oct 31 - Thursday","name":"Halloween","type":"Observance","details":""},{"date":"Dec 21 - Saturday","name":"December Solstice","type":"Season","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 24 - Tuesday","name":"Christmas Eve","type":"Observance","details":""},{"date":"Dec 25 - Wednesday","name":"Christmas Day","type":"National Holiday","details":""},{"date":"Dec 26 - Thursday","name":"2nd Christmas Day","type":"National Holiday","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Restricted Trading Day","details":""},{"date":"Dec 31 - Tuesday","name":"New Year's Eve","type":"Observance","details":""}]}
curl --location --request GET 'https://zylalabs.com/api/260/check+holidays+api/7773/holidays+by+country?country=Denmark&year=2024' --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 "Get Holidays" endpoint returns a list of holidays for a specified country and year, including details like date, name, type (public or non-public), and the day of the week. The "Available Countries" endpoint provides a list of all supported countries. The "Holidays by Country" endpoint returns holidays for a specific country and year, detailing the date, name, type, and additional information.
Key fields in the response data include "date" (holiday date), "localName" (name in the local language), "name" (holiday name), "type" (public or non-public), and "countryCode" (ISO code of the country). These fields help identify and categorize each holiday.
The response data is organized in JSON format, with each holiday represented as an object within an array. Each object contains key-value pairs for attributes like date, name, and type, making it easy to parse and utilize programmatically.
The "Get Holidays" and "Holidays by Country" endpoints require parameters such as "countryCode" (ISO code of the country) and "year" (optional). Users can customize requests by specifying the month and day for more precise holiday information.
The "Get Holidays" endpoint provides a comprehensive list of holidays for a specified country and year. The "Available Countries" endpoint lists all countries supported by the API. The "Holidays by Country" endpoint offers detailed holiday information for a specific country, including observances and national holidays.
Users can utilize the returned data to plan events, manage work schedules, or create travel itineraries. For example, by analyzing the number of public holidays in a year, businesses can assess potential operational days and adjust staffing accordingly.
The data is sourced from official government holiday calendars and reputable international databases. This ensures a high level of accuracy and reliability in the holiday information provided by the API.
If a request returns partial or empty results, users should verify the parameters used, such as the country code and year. Additionally, checking the API documentation for supported countries and valid date ranges can help ensure accurate requests.
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:
157ms
Service Level:
100%
Response Time:
1,366ms
Service Level:
100%
Response Time:
81ms
Service Level:
100%
Response Time:
76ms
Service Level:
100%
Response Time:
163ms
Service Level:
100%
Response Time:
97ms
Service Level:
75%
Response Time:
295ms
Service Level:
100%
Response Time:
604ms
Service Level:
40%
Response Time:
122ms
Service Level:
100%
Response Time:
488ms
Service Level:
100%
Response Time:
1,075ms
Service Level:
100%
Response Time:
3,420ms
Service Level:
100%
Response Time:
601ms
Service Level:
100%
Response Time:
965ms
Service Level:
100%
Response Time:
459ms
Service Level:
100%
Response Time:
513ms
Service Level:
100%
Response Time:
1,045ms
Service Level:
100%
Response Time:
381ms
Service Level:
100%
Response Time:
1,069ms