🗓️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

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:

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)

Last updated