> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.holidays.rest/holidays-rest-api/countries/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.holidays.rest/_mcp/server. # countries GET https://api.holidays.rest/v1/countries This endpoint retrieves all countries. You can use the `alpha2` code from the response to retrieve a specific country including its subdivisions or public holidays for a specific country. Reference: https://docs.holidays.rest/holidays-rest-api/countries ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Response ### 200 OK - `list of V1CountriesGetResponsesContentApplicationJsonSchemaItems` ## Types ### V1CountriesGetResponsesContentApplicationJsonSchemaItems - `name` (string, required) - `long_name` (string, required) - `region` (string, required) - `subregion` (string, required) - `world_region` (string, required) - `alpha2` (string, required) ## Examples **Response** ```json [ { "name": "Afghanistan", "long_name": "The Islamic Republic of Afghanistan", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "AF" }, { "name": "Åland Islands", "long_name": "Åland", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "AX" }, { "name": "Albania", "long_name": "The Republic of Albania", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "AL" }, { "name": "Algeria", "long_name": "The People's Democratic Republic of Algeria", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "DZ" }, { "name": "American Samoa", "long_name": "The Territory of American Samoa", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "AS" }, { "name": "Andorra", "long_name": "The Principality of Andorra", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "AD" }, { "name": "Angola", "long_name": "The Republic of Angola", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "AO" }, { "name": "Anguilla", "long_name": "Anguilla", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "AI" }, { "name": "Antarctica", "long_name": "Antarctica", "region": "", "subregion": "", "world_region": "AMER", "alpha2": "AQ" }, { "name": "Antigua and Barbuda", "long_name": "Antigua and Barbuda", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "AG" }, { "name": "Argentina", "long_name": "The Argentine Republic", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "AR" }, { "name": "Armenia", "long_name": "The Republic of Armenia", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "AM" }, { "name": "Aruba", "long_name": "Aruba", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "AW" }, { "name": "Australia", "long_name": "The Commonwealth of Australia", "region": "Oceania", "subregion": "Australia and New Zealand", "world_region": "APAC", "alpha2": "AU" }, { "name": "Austria", "long_name": "The Republic of Austria", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "AT" }, { "name": "Azerbaijan", "long_name": "The Republic of Azerbaijan", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "AZ" }, { "name": "Bahamas", "long_name": "The Commonwealth of The Bahamas", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "BS" }, { "name": "Bahrain", "long_name": "The Kingdom of Bahrain", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "BH" }, { "name": "Bangladesh", "long_name": "The People's Republic of Bangladesh", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "BD" }, { "name": "Barbados", "long_name": "Barbados", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "BB" }, { "name": "Belarus", "long_name": "The Republic of Belarus", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "BY" }, { "name": "Belgium", "long_name": "The Kingdom of Belgium", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "BE" }, { "name": "Belize", "long_name": "Belize", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "BZ" }, { "name": "Benin", "long_name": "The Republic of Benin", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "BJ" }, { "name": "Bermuda", "long_name": "Bermuda", "region": "Americas", "subregion": "Northern America", "world_region": "AMER", "alpha2": "BM" }, { "name": "Bhutan", "long_name": "The Kingdom of Bhutan", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "BT" }, { "name": "Bolivia (Plurinational State of)", "long_name": "The Plurinational State of Bolivia", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "BO" }, { "name": "Bonaire, Sint Eustatius and Saba", "long_name": "Bonaire, Sint Eustatius and Saba", "region": "Americas", "subregion": "Caribbean", "world_region": "APAC", "alpha2": "BQ" }, { "name": "Bosnia and Herzegovina", "long_name": "Bosnia and Herzegovina", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "BA" }, { "name": "Botswana", "long_name": "The Republic of Botswana", "region": "Africa", "subregion": "Southern Africa", "world_region": "EMEA", "alpha2": "BW" }, { "name": "Bouvet Island", "long_name": "Bouvet Island", "region": "", "subregion": "", "world_region": "APAC", "alpha2": "BV" }, { "name": "Brazil", "long_name": "The Federative Republic of Brazil", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "BR" }, { "name": "British Indian Ocean Territory", "long_name": "The British Indian Ocean Territory", "region": "Africa", "subregion": "Eastern Africa", "world_region": "APAC", "alpha2": "IO" }, { "name": "Brunei Darussalam", "long_name": "The Nation of Brunei, the Abode of Peace", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "BN" }, { "name": "Bulgaria", "long_name": "The Republic of Bulgaria", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "BG" }, { "name": "Burkina Faso", "long_name": "Burkina Faso", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "BF" }, { "name": "Burundi", "long_name": "The Republic of Burundi", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "BI" }, { "name": "Cabo Verde", "long_name": "The Republic of Cabo Verde", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "CV" }, { "name": "Cambodia", "long_name": "The Kingdom of Cambodia", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "KH" }, { "name": "Cameroon", "long_name": "The Republic of Cameroon", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "CM" }, { "name": "Canada", "long_name": "Canada", "region": "Americas", "subregion": "Northern America", "world_region": "AMER", "alpha2": "CA" }, { "name": "Cayman Islands", "long_name": "The Cayman Islands", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "KY" }, { "name": "Central African Republic", "long_name": "The Central African Republic", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "CF" }, { "name": "Chad", "long_name": "The Republic of Chad", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "TD" }, { "name": "Chile", "long_name": "The Republic of Chile", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "CL" }, { "name": "China", "long_name": "The People's Republic of China", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "CN" }, { "name": "Christmas Island", "long_name": "The Territory of Christmas Island", "region": "Oceania", "subregion": "Australia and New Zealand", "world_region": "APAC", "alpha2": "CX" }, { "name": "Cocos (Keeling) Islands", "long_name": "The Territory of Cocos (Keeling) Islands", "region": "Oceania", "subregion": "Australia and New Zealand", "world_region": "APAC", "alpha2": "CC" }, { "name": "Colombia", "long_name": "The Republic of Colombia", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "CO" }, { "name": "Comoros", "long_name": "The Union of the Comoros", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "KM" }, { "name": "Congo", "long_name": "The Republic of the Congo", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "CG" }, { "name": "Congo (Democratic Republic of the)", "long_name": "The Democratic Republic of the Congo", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "CD" }, { "name": "Cook Islands", "long_name": "The Cook Islands", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "CK" }, { "name": "Costa Rica", "long_name": "The Republic of Costa Rica", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "CR" }, { "name": "Côte d'Ivoire", "long_name": "The Republic of Côte d'Ivoire", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "CI" }, { "name": "Croatia", "long_name": "The Republic of Croatia", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "HR" }, { "name": "Cuba", "long_name": "The Republic of Cuba", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "CU" }, { "name": "Curaçao", "long_name": "The Country of Curaçao", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "CW" }, { "name": "Cyprus", "long_name": "The Republic of Cyprus", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "CY" }, { "name": "Czechia", "long_name": "The Czech Republic", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "CZ" }, { "name": "Denmark", "long_name": "The Kingdom of Denmark", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "DK" }, { "name": "Djibouti", "long_name": "The Republic of Djibouti", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "DJ" }, { "name": "Dominica", "long_name": "The Commonwealth of Dominica", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "DM" }, { "name": "Dominican Republic", "long_name": "The Dominican Republic", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "DO" }, { "name": "Ecuador", "long_name": "The Republic of Ecuador", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "EC" }, { "name": "Egypt", "long_name": "The Arab Republic of Egypt", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "EG" }, { "name": "El Salvador", "long_name": "The Republic of El Salvador", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "SV" }, { "name": "Equatorial Guinea", "long_name": "The Republic of Equatorial Guinea", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "GQ" }, { "name": "Eritrea", "long_name": "The State of Eritrea", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "ER" }, { "name": "Estonia", "long_name": "The Republic of Estonia", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "EE" }, { "name": "Eswatini", "long_name": "The Kingdom of Eswatini", "region": "Africa", "subregion": "Southern Africa", "world_region": "EMEA", "alpha2": "SZ" }, { "name": "Ethiopia", "long_name": "The Federal Democratic Republic of Ethiopia", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "ET" }, { "name": "Falkland Islands (Malvinas)", "long_name": "The Falkland Islands", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "FK" }, { "name": "Faroe Islands", "long_name": "The Faroe Islands", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "FO" }, { "name": "Fiji", "long_name": "The Republic of Fiji", "region": "Oceania", "subregion": "Melanesia", "world_region": "APAC", "alpha2": "FJ" }, { "name": "Finland", "long_name": "The Republic of Finland", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "FI" }, { "name": "France", "long_name": "The French Republic", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "FR" }, { "name": "French Guiana", "long_name": "Guyane", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "GF" }, { "name": "French Polynesia", "long_name": "French Polynesia", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "PF" }, { "name": "French Southern Territories", "long_name": "The French Southern and Antarctic Lands", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "TF" }, { "name": "Gabon", "long_name": "The Gabonese Republic", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "GA" }, { "name": "Gambia", "long_name": "The Republic of The Gambia", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "GM" }, { "name": "Georgia", "long_name": "Georgia", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "GE" }, { "name": "Germany", "long_name": "The Federal Republic of Germany", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "DE" }, { "name": "Ghana", "long_name": "The Republic of Ghana", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "GH" }, { "name": "Gibraltar", "long_name": "Gibraltar", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "GI" }, { "name": "Greece", "long_name": "The Hellenic Republic", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "GR" }, { "name": "Greenland", "long_name": "Kalaallit Nunaat", "region": "Americas", "subregion": "Northern America", "world_region": "EMEA", "alpha2": "GL" }, { "name": "Grenada", "long_name": "Grenada", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "GD" }, { "name": "Guadeloupe", "long_name": "Guadeloupe", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "GP" }, { "name": "Guam", "long_name": "The Territory of Guam", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "GU" }, { "name": "Guatemala", "long_name": "The Republic of Guatemala", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "GT" }, { "name": "Guernsey", "long_name": "The Bailiwick of Guernsey", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "GG" }, { "name": "Guinea", "long_name": "The Republic of Guinea", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "GN" }, { "name": "Guinea-Bissau", "long_name": "The Republic of Guinea-Bissau", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "GW" }, { "name": "Guyana", "long_name": "The Co-operative Republic of Guyana", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "GY" }, { "name": "Haiti", "long_name": "The Republic of Haiti", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "HT" }, { "name": "Heard Island and McDonald Islands", "long_name": "The Territory of Heard Island and McDonald Islands", "region": "", "subregion": "", "world_region": "APAC", "alpha2": "HM" }, { "name": "Holy See", "long_name": "The Holy See", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "VA" }, { "name": "Honduras", "long_name": "The Republic of Honduras", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "HN" }, { "name": "Hong Kong", "long_name": "The Hong Kong Special Administrative Region of China", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "HK" }, { "name": "Hungary", "long_name": "Hungary", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "HU" }, { "name": "Iceland", "long_name": "Iceland", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "IS" }, { "name": "India", "long_name": "The Republic of India", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "IN" }, { "name": "Indonesia", "long_name": "The Republic of Indonesia", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "ID" }, { "name": "Iran (Islamic Republic of)", "long_name": "The Islamic Republic of Iran", "region": "Asia", "subregion": "Southern Asia", "world_region": "EMEA", "alpha2": "IR" }, { "name": "Iraq", "long_name": "The Republic of Iraq", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "IQ" }, { "name": "Ireland", "long_name": "Ireland", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "IE" }, { "name": "Isle of Man", "long_name": "The Isle of Man", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "IM" }, { "name": "Israel", "long_name": "The State of Israel", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "IL" }, { "name": "Italy", "long_name": "The Italian Republic", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "IT" }, { "name": "Jamaica", "long_name": "Jamaica", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "JM" }, { "name": "Japan", "long_name": "Japan", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "JP" }, { "name": "Jersey", "long_name": "The Bailiwick of Jersey", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "JE" }, { "name": "Jordan", "long_name": "The Hashemite Kingdom of Jordan", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "JO" }, { "name": "Kazakhstan", "long_name": "The Republic of Kazakhstan", "region": "Asia", "subregion": "Central Asia", "world_region": "EMEA", "alpha2": "KZ" }, { "name": "Kenya", "long_name": "The Republic of Kenya", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "KE" }, { "name": "Kiribati", "long_name": "The Republic of Kiribati", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "KI" }, { "name": "Korea (Democratic People's Republic of)", "long_name": "The Democratic People's Republic of Korea", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "KP" }, { "name": "Korea (Republic of)", "long_name": "The Republic of Korea", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "KR" }, { "name": "Kuwait", "long_name": "The State of Kuwait", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "KW" }, { "name": "Kyrgyzstan", "long_name": "The Kyrgyz Republic", "region": "Asia", "subregion": "Central Asia", "world_region": "EMEA", "alpha2": "KG" }, { "name": "Lao People's Democratic Republic", "long_name": "The Lao People's Democratic Republic", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "LA" }, { "name": "Latvia", "long_name": "The Republic of Latvia", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "LV" }, { "name": "Lebanon", "long_name": "The Lebanese Republic", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "LB" }, { "name": "Lesotho", "long_name": "The Kingdom of Lesotho", "region": "Africa", "subregion": "Southern Africa", "world_region": "EMEA", "alpha2": "LS" }, { "name": "Liberia", "long_name": "The Republic of Liberia", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "LR" }, { "name": "Libya", "long_name": "The State of Libya", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "LY" }, { "name": "Liechtenstein", "long_name": "The Principality of Liechtenstein", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "LI" }, { "name": "Lithuania", "long_name": "The Republic of Lithuania", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "LT" }, { "name": "Luxembourg", "long_name": "The Grand Duchy of Luxembourg", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "LU" }, { "name": "Macao", "long_name": "The Macao Special Administrative Region of China", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "MO" }, { "name": "Madagascar", "long_name": "The Republic of Madagascar", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "MG" }, { "name": "Malawi", "long_name": "The Republic of Malawi", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "MW" }, { "name": "Malaysia", "long_name": "Malaysia", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "MY" }, { "name": "Maldives", "long_name": "The Republic of Maldives", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "MV" }, { "name": "Mali", "long_name": "The Republic of Mali", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "ML" }, { "name": "Malta", "long_name": "The Republic of Malta", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "MT" }, { "name": "Marshall Islands", "long_name": "The Republic of the Marshall Islands", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "MH" }, { "name": "Martinique", "long_name": "Martinique", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "MQ" }, { "name": "Mauritania", "long_name": "The Islamic Republic of Mauritania", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "MR" }, { "name": "Mauritius", "long_name": "The Republic of Mauritius", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "MU" }, { "name": "Mayotte", "long_name": "The Department of Mayotte", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "YT" }, { "name": "Mexico", "long_name": "The United Mexican States", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "MX" }, { "name": "Micronesia (Federated States of)", "long_name": "The Federated States of Micronesia", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "FM" }, { "name": "Moldova (Republic of)", "long_name": "The Republic of Moldova", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "MD" }, { "name": "Monaco", "long_name": "The Principality of Monaco", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "MC" }, { "name": "Mongolia", "long_name": "Mongolia", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "MN" }, { "name": "Montenegro", "long_name": "Montenegro", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "ME" }, { "name": "Montserrat", "long_name": "Montserrat", "region": "Americas", "subregion": "Caribbean", "world_region": "EMEA", "alpha2": "MS" }, { "name": "Morocco", "long_name": "The Kingdom of Morocco", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "MA" }, { "name": "Mozambique", "long_name": "The Republic of Mozambique", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "MZ" }, { "name": "Myanmar", "long_name": "The Republic of the Union of Myanmar", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "MM" }, { "name": "Namibia", "long_name": "The Republic of Namibia", "region": "Africa", "subregion": "Southern Africa", "world_region": "EMEA", "alpha2": "NA" }, { "name": "Nauru", "long_name": "The Republic of Nauru", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "NR" }, { "name": "Nepal", "long_name": "The Federal Democratic Republic of Nepal", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "NP" }, { "name": "Netherlands", "long_name": "The Kingdom of the Netherlands", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "NL" }, { "name": "New Caledonia", "long_name": "New Caledonia", "region": "Oceania", "subregion": "Melanesia", "world_region": "APAC", "alpha2": "NC" }, { "name": "New Zealand", "long_name": "New Zealand", "region": "Oceania", "subregion": "Australia and New Zealand", "world_region": "APAC", "alpha2": "NZ" }, { "name": "Nicaragua", "long_name": "The Republic of Nicaragua", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "NI" }, { "name": "Niger", "long_name": "The Republic of the Niger", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "NE" }, { "name": "Nigeria", "long_name": "The Federal Republic of Nigeria", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "NG" }, { "name": "Niue", "long_name": "Niue", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "NU" }, { "name": "Norfolk Island", "long_name": "The Territory of Norfolk Island", "region": "Oceania", "subregion": "Australia and New Zealand", "world_region": "APAC", "alpha2": "NF" }, { "name": "North Macedonia", "long_name": "The Republic of North Macedonia", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "MK" }, { "name": "Northern Mariana Islands", "long_name": "The Commonwealth of the Northern Mariana Islands", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "MP" }, { "name": "Norway", "long_name": "The Kingdom of Norway", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "NO" }, { "name": "Oman", "long_name": "The Sultanate of Oman", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "OM" }, { "name": "Pakistan", "long_name": "The Islamic Republic of Pakistan", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "PK" }, { "name": "Palau", "long_name": "The Republic of Palau", "region": "Oceania", "subregion": "Micronesia", "world_region": "APAC", "alpha2": "PW" }, { "name": "Palestine, State of", "long_name": "The State of Palestine", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "PS" }, { "name": "Panama", "long_name": "The Republic of Panamá", "region": "Americas", "subregion": "Central America", "world_region": "AMER", "alpha2": "PA" }, { "name": "Papua New Guinea", "long_name": "The Independent State of Papua New Guinea", "region": "Oceania", "subregion": "Melanesia", "world_region": "APAC", "alpha2": "PG" }, { "name": "Paraguay", "long_name": "The Republic of Paraguay", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "PY" }, { "name": "Peru", "long_name": "The Republic of Perú", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "PE" }, { "name": "Philippines", "long_name": "The Republic of the Philippines", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "PH" }, { "name": "Pitcairn", "long_name": "The Pitcairn, Henderson, Ducie and Oeno Islands", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "PN" }, { "name": "Poland", "long_name": "The Republic of Poland", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "PL" }, { "name": "Portugal", "long_name": "The Portuguese Republic", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "PT" }, { "name": "Puerto Rico", "long_name": "The Commonwealth of Puerto Rico", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "PR" }, { "name": "Qatar", "long_name": "The State of Qatar", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "QA" }, { "name": "Réunion", "long_name": "Réunion", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "RE" }, { "name": "Romania", "long_name": "Romania", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "RO" }, { "name": "Russian Federation", "long_name": "The Russian Federation", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "RU" }, { "name": "Rwanda", "long_name": "The Republic of Rwanda", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "RW" }, { "name": "Saint Barthélemy", "long_name": "The Collectivity of Saint-Barthélemy", "region": "Americas", "subregion": "Caribbean", "world_region": "APAC", "alpha2": "BL" }, { "name": "Saint Helena, Ascension and Tristan da Cunha", "long_name": "Saint Helena, Ascension and Tristan da Cunha", "region": "Africa", "subregion": "Western Africa", "world_region": "APAC", "alpha2": "SH" }, { "name": "Saint Kitts and Nevis", "long_name": "Saint Kitts and Nevis", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "KN" }, { "name": "Saint Lucia", "long_name": "Saint Lucia", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "LC" }, { "name": "Saint Martin (French part)", "long_name": "The Collectivity of Saint-Martin", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "MF" }, { "name": "Saint Pierre and Miquelon", "long_name": "The Overseas Collectivity of Saint-Pierre and Miquelon", "region": "Americas", "subregion": "Northern America", "world_region": "AMER", "alpha2": "PM" }, { "name": "Saint Vincent and the Grenadines", "long_name": "Saint Vincent and the Grenadines", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "VC" }, { "name": "Samoa", "long_name": "The Independent State of Samoa", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "WS" }, { "name": "San Marino", "long_name": "The Republic of San Marino", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "SM" }, { "name": "Sao Tome and Principe", "long_name": "The Democratic Republic of São Tomé and Príncipe", "region": "Africa", "subregion": "Middle Africa", "world_region": "EMEA", "alpha2": "ST" }, { "name": "Saudi Arabia", "long_name": "The Kingdom of Saudi Arabia", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "SA" }, { "name": "Senegal", "long_name": "The Republic of Senegal", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "SN" }, { "name": "Serbia", "long_name": "The Republic of Serbia", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "RS" }, { "name": "Seychelles", "long_name": "The Republic of Seychelles", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "SC" }, { "name": "Sierra Leone", "long_name": "The Republic of Sierra Leone", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "SL" }, { "name": "Singapore", "long_name": "The Republic of Singapore", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "SG" }, { "name": "Sint Maarten (Dutch part)", "long_name": "Sint Maarten", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "SX" }, { "name": "Slovakia", "long_name": "The Slovak Republic", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "SK" }, { "name": "Slovenia", "long_name": "The Republic of Slovenia", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "SI" }, { "name": "Solomon Islands", "long_name": "The Solomon Islands", "region": "Oceania", "subregion": "Melanesia", "world_region": "APAC", "alpha2": "SB" }, { "name": "Somalia", "long_name": "The Federal Republic of Somalia", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "SO" }, { "name": "South Africa", "long_name": "The Republic of South Africa", "region": "Africa", "subregion": "Southern Africa", "world_region": "EMEA", "alpha2": "ZA" }, { "name": "South Georgia and the South Sandwich Islands", "long_name": "South Georgia and the South Sandwich Islands", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "GS" }, { "name": "South Sudan", "long_name": "The Republic of South Sudan", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "SS" }, { "name": "Spain", "long_name": "The Kingdom of Spain", "region": "Europe", "subregion": "Southern Europe", "world_region": "EMEA", "alpha2": "ES" }, { "name": "Sri Lanka", "long_name": "The Democratic Socialist Republic of Sri Lanka", "region": "Asia", "subregion": "Southern Asia", "world_region": "APAC", "alpha2": "LK" }, { "name": "Sudan", "long_name": "The Republic of the Sudan", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "SD" }, { "name": "Suriname", "long_name": "The Republic of Suriname", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "SR" }, { "name": "Svalbard and Jan Mayen", "long_name": "Svalbard and Jan Mayen", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "SJ" }, { "name": "Sweden", "long_name": "The Kingdom of Sweden", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "SE" }, { "name": "Switzerland", "long_name": "The Swiss Confederation", "region": "Europe", "subregion": "Western Europe", "world_region": "EMEA", "alpha2": "CH" }, { "name": "Syrian Arab Republic", "long_name": "The Syrian Arab Republic", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "SY" }, { "name": "Taiwan, Province of China", "long_name": "The Republic of China", "region": "Asia", "subregion": "Eastern Asia", "world_region": "APAC", "alpha2": "TW" }, { "name": "Tajikistan", "long_name": "The Republic of Tajikistan", "region": "Asia", "subregion": "Central Asia", "world_region": "EMEA", "alpha2": "TJ" }, { "name": "Tanzania, United Republic of", "long_name": "The United Republic of Tanzania", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "TZ" }, { "name": "Thailand", "long_name": "The Kingdom of Thailand", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "TH" }, { "name": "Timor-Leste", "long_name": "The Democratic Republic of Timor-Leste", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "TL" }, { "name": "Togo", "long_name": "The Togolese Republic", "region": "Africa", "subregion": "Western Africa", "world_region": "EMEA", "alpha2": "TG" }, { "name": "Tokelau", "long_name": "Tokelau", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "TK" }, { "name": "Tonga", "long_name": "The Kingdom of Tonga", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "TO" }, { "name": "Trinidad and Tobago", "long_name": "The Republic of Trinidad and Tobago", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "TT" }, { "name": "Tunisia", "long_name": "The Republic of Tunisia", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "TN" }, { "name": "Türkiye", "long_name": "The Republic of Türkiye", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "TR" }, { "name": "Turkmenistan", "long_name": "Turkmenistan", "region": "Asia", "subregion": "Central Asia", "world_region": "EMEA", "alpha2": "TM" }, { "name": "Turks and Caicos Islands", "long_name": "The Turks and Caicos Islands", "region": "Americas", "subregion": "Caribbean", "world_region": "APAC", "alpha2": "TC" }, { "name": "Tuvalu", "long_name": "Tuvalu", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "TV" }, { "name": "Uganda", "long_name": "The Republic of Uganda", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "UG" }, { "name": "Ukraine", "long_name": "Ukraine", "region": "Europe", "subregion": "Eastern Europe", "world_region": "EMEA", "alpha2": "UA" }, { "name": "United Arab Emirates", "long_name": "The United Arab Emirates", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "AE" }, { "name": "United Kingdom of Great Britain and Northern Ireland", "long_name": "The United Kingdom of Great Britain and Northern Ireland", "region": "Europe", "subregion": "Northern Europe", "world_region": "EMEA", "alpha2": "GB" }, { "name": "United States Minor Outlying Islands", "long_name": "United States Minor Outlying Islands", "region": "Americas", "subregion": "Northern America", "world_region": "AMER", "alpha2": "UM" }, { "name": "United States of America", "long_name": "The United States of America", "region": "Americas", "subregion": "Northern America", "world_region": "AMER", "alpha2": "US" }, { "name": "Uruguay", "long_name": "The Oriental Republic of Uruguay", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "UY" }, { "name": "Uzbekistan", "long_name": "The Republic of Uzbekistan", "region": "Asia", "subregion": "Central Asia", "world_region": "EMEA", "alpha2": "UZ" }, { "name": "Vanuatu", "long_name": "The Republic of Vanuatu", "region": "Oceania", "subregion": "Melanesia", "world_region": "APAC", "alpha2": "VU" }, { "name": "Venezuela (Bolivarian Republic of)", "long_name": "The Bolivarian Republic of Venezuela", "region": "Americas", "subregion": "South America", "world_region": "AMER", "alpha2": "VE" }, { "name": "Viet Nam", "long_name": "The Socialist Republic of Viet Nam", "region": "Asia", "subregion": "South-Eastern Asia", "world_region": "APAC", "alpha2": "VN" }, { "name": "Virgin Islands (British)", "long_name": "The Virgin Islands", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "VG" }, { "name": "Virgin Islands (U.S.)", "long_name": "The Virgin Islands of the United States", "region": "Americas", "subregion": "Caribbean", "world_region": "AMER", "alpha2": "VI" }, { "name": "Wallis and Futuna", "long_name": "The Territory of the Wallis and Futuna Islands", "region": "Oceania", "subregion": "Polynesia", "world_region": "APAC", "alpha2": "WF" }, { "name": "Western Sahara", "long_name": "The Sahrawi Arab Democratic Republic", "region": "Africa", "subregion": "Northern Africa", "world_region": "EMEA", "alpha2": "EH" }, { "name": "Yemen", "long_name": "The Republic of Yemen", "region": "Asia", "subregion": "Western Asia", "world_region": "EMEA", "alpha2": "YE" }, { "name": "Zambia", "long_name": "The Republic of Zambia", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "ZM" }, { "name": "Zimbabwe", "long_name": "The Republic of Zimbabwe", "region": "Africa", "subregion": "Eastern Africa", "world_region": "EMEA", "alpha2": "ZW" } ] ``` **SDK Code** ```python countries_example import requests url = "https://api.holidays.rest/v1/countries" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript countries_example const url = 'https://api.holidays.rest/v1/countries'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go countries_example package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.holidays.rest/v1/countries" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby countries_example require 'uri' require 'net/http' url = URI("https://api.holidays.rest/v1/countries") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java countries_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.holidays.rest/v1/countries") .header("Authorization", "Bearer ") .asString(); ``` ```php countries_example request('GET', 'https://api.holidays.rest/v1/countries', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp countries_example using RestSharp; var client = new RestClient("https://api.holidays.rest/v1/countries"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift countries_example import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.holidays.rest/v1/countries")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```