🗓
Holidays API
Keep track of public and non-public holidays for countries around the world using our Holidays API. You can specify any country and obtain all holidays present in the specified period of time.
You need to provide your API key for every API request you make. Please refer to the Getting Started section for more details.
You can check our Errors section to understand how we handle errors and the responses you will receive in cases when errors occur.

Get holidays (/holidays)

Endpoint used for getting holidays and their details in the specified period of time.

Request parameters

Key
Explanation
Type
Required
country
Country code of the country you would like to obtain holidays for. Provided in ISO 3166-1 alpha-2 format.
string
true
year
Year for which you woud like to obtain holidays for. Defaults to current year.
number
false
month
Month for which you would like to obtain holidays for
number
false
day
Day for which you would like to obtain holidays for.
number
false

Examples

The following example will return all holidays in Spain for the current year:
GET /holidays?country=ES
RESPONSE:
[
{
"name": {
"international": "New Year's Day",
"local": "Año Nuevo"
},
"country": {
"code": "ES",
"name": "Spain",
"language": "ES"
},
"details": {
"type": "public",
"date": "2022/01/01",
"year": "2022",
"month": "01",
"day": "01",
"week_day": "Saturday"
}
},
{
"name": {
"international": "Epiphany",
"local": "Día de los Reyes Magos"
},
"country": {
"code": "ES",
"name": "Spain",
"language": "ES"
},
"details": {
"type": "public",
"date": "2022/01/06",
"year": "2022",
"month": "01",
"day": "06",
"week_day": "Thursday"
}
}
...
]
If you would like to get holidays for a specific year, month or day, you can leverage the use of our date filters. For example, if you would like to get all holidays in France in May 2021 you could send the following request:
GET /holidays?country=FR&year=2021&month=5
RESPONSE:
[
{
"name": {
"international": "Labour Day",
"local": "Fête du travail"
},
"country": {
"code": "FR",
"name": "France",
"language": "FR"
},
"details": {
"type": "public",
"date": "2020/05/01",
"year": "2020",
"month": "05",
"day": "01",
"week_day": "Friday"
}
},
{
"name": {
"international": "Victory Day",
"local": "Fête de la Victoire 1945"
},
"country": {
"code": "FR",
"name": "France",
"language": "FR"
},
"details": {
"type": "public",
"date": "2020/05/08",
"year": "2020",
"month": "05",
"day": "08",
"week_day": "Friday"
}
}
// ...
]
You can use any combination of year, month, and day parameters as long as you provide a valid combination.

Response structure

Every successful response will have the structure explained in the table below:
Key
Explanation
Type
name.international
Internation holiday name, specified in English language.
string
name.local
Local holiday name, expressed in country's local language.
string
country.code
Code of the country the holiday is taking place in. Specified in ISO 3166-1 alpha-2 format.
string
country.name
Official, full-lengh country name in which the holiday is taking place.
string
country.language
Abbreviation of the official country language.
string
details.type
Type of the holiday. Possible holiday types are: public, bank (banks and offices are closed), school (schools are closed), optional (majority of people take a day off), observance (optional festivity, no paid day off).
string
details.date
The date on which holiday occurs, provided in format year/month/day.
string
details.year
The year in which a holiday occurs.
string
details.month
The month in which a holiday occurs.
string
details.day
The day on which a holiday occurs.
string
details.week_day
The day of the week on which a holiday occurs (e.g. “Saturday”).
string

Supported countries

Our Holidays API supports 195 worldwide countries. You can find the list of supported countries in the list below:
  • 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)
Copy link
On this page
Get holidays (/holidays)
Request parameters
Examples
Response structure
Supported countries