Retrieve a list of countries and their codes.
Retrieve a list of countries through the following request:
| HTTP Method | Request URI |
|---|---|
|
GET |
https://api.vdms.io/sec/cps/v2.0/appendix/country-codes |
This endpointIdentifies a request's connection point to our REST API service. only takes advantage of common request headers.
Unlike requests to api.edgecast.com, requests to our API gateway (api.vdms.io) require an access token (OAuth).
Request body parameters are not required by this endpoint.
The response to the above request includes an HTTP status code, response headers, and a response body.
A status code indicates whether the request was successfully performed.
The response for this endpoint only includes standard HTTP response headers.
The response body for a successful request (200 OK) contains the following response elements:
| Name | Data Type | Description |
|---|---|---|
|
@id |
String |
Indicates the relative path to an endpoint through which you may retrieve a list of countries. |
|
@type |
String |
Returns Collection. |
|
items |
Array of objects |
Contains a list of countries. |
|
total_items |
Integer |
Indicates the total number of countries. |
The items array describes each country through the following properties:
| Name | Data Type | Description |
|---|---|---|
|
country |
String |
Identifies a country by its name. |
|
two_letter_code |
String |
Identifies a country by its country code. |
The response body for an unsuccessful request will contain an error response that provides additional information.
A sample JSON request is shown below.
GET https://api.vdms.io/sec/cps/v2.0/appendix/country-codes HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: api.vdms.io
A sample JSON response is shown below.
HTTP/1.1 200 OK
Cache-Control: no-cache
Content-Type: application/json; charset=utf-8
Date: Thu, 15 Apr 2021 12:00:00 GMT
Content-Length: 16627
{
"@id": "/v2.0/appendix/country-codes",
"@type": "Collection",
"items": [{
"country": "Afghanistan",
"two_letter_code": "AF"
}, {
"country": "Albania",
"two_letter_code": "AL"
}, {
"country": "Algeria",
"two_letter_code": "DZ"
}, {
"country": "American Samoa",
"two_letter_code": "AS"
}, {
"country": "Andorra",
"two_letter_code": "AD"
}, {
"country": "Angola",
"two_letter_code": "AO"
}, {
"country": "Anguilla",
"two_letter_code": "AI"
}, {
"country": "Antarctica",
"two_letter_code": "AQ"
}, {
"country": "Antigua and Barbuda",
"two_letter_code": "AG"
}, {
"country": "Argentina",
"two_letter_code": "AR"
}, {
"country": "Armenia",
"two_letter_code": "AM"
}, {
"country": "Aruba",
"two_letter_code": "AW"
}, {
"country": "Australia",
"two_letter_code": "AU"
}, {
"country": "Austria",
"two_letter_code": "AT"
}, {
"country": "Azerbaijan",
"two_letter_code": "AZ"
}, {
"country": "Bahamas",
"two_letter_code": "BS"
}, {
"country": "Bahrain",
"two_letter_code": "BH"
}, {
"country": "Bangladesh",
"two_letter_code": "BD"
}, {
"country": "Barbados",
"two_letter_code": "BB"
}, {
"country": "Belarus",
"two_letter_code": "BY"
}, {
"country": "Belgium",
"two_letter_code": "BE"
}, {
"country": "Belize",
"two_letter_code": "BZ"
}, {
"country": "Benin",
"two_letter_code": "BJ"
}, {
"country": "Bermuda",
"two_letter_code": "BM"
}, {
"country": "Bhutan",
"two_letter_code": "BT"
}, {
"country": "Bolivia, Plurinational State of",
"two_letter_code": "BO"
}, {
"country": "Bonaire, Sint Eustatius and Saba",
"two_letter_code": "BQ"
}, {
"country": "Bosnia and Herzegovina",
"two_letter_code": "BA"
}, {
"country": "Botswana",
"two_letter_code": "BW"
}, {
"country": "Bouvet Island",
"two_letter_code": "BV"
}, {
"country": "Brazil",
"two_letter_code": "BR"
}, {
"country": "British Indian Ocean Territory",
"two_letter_code": "IO"
}, {
"country": "Brunei Darussalam",
"two_letter_code": "BN"
}, {
"country": "Bulgaria",
"two_letter_code": "BG"
}, {
"country": "Burkina Faso",
"two_letter_code": "BF"
}, {
"country": "Burundi",
"two_letter_code": "BI"
}, {
"country": "Cabo Verde",
"two_letter_code": "CV"
}, {
"country": "Cambodia",
"two_letter_code": "KH"
}, {
"country": "Cameroon",
"two_letter_code": "CM"
}, {
"country": "Canada",
"two_letter_code": "CA"
}, {
"country": "Cayman Islands",
"two_letter_code": "KY"
}, {
"country": "Central African Republic",
"two_letter_code": "CF"
}, {
"country": "Chad",
"two_letter_code": "TD"
}, {
"country": "Chile",
"two_letter_code": "CL"
}, {
"country": "China",
"two_letter_code": "CN"
}, {
"country": "Christmas Island",
"two_letter_code": "CX"
}, {
"country": "Cocos (Keeling) Islands",
"two_letter_code": "CC"
}, {
"country": "Colombia",
"two_letter_code": "CO"
}, {
"country": "Comoros",
"two_letter_code": "KM"
}, {
"country": "Congo",
"two_letter_code": "CG"
}, {
"country": "Congo, the Democratic Republic of the",
"two_letter_code": "CD"
}, {
"country": "Cook Islands",
"two_letter_code": "CK"
}, {
"country": "Costa Rica",
"two_letter_code": "CR"
}, {
"country": "Côte d'Ivoire",
"two_letter_code": "CI"
}, {
"country": "Croatia",
"two_letter_code": "HR"
}, {
"country": "Cuba",
"two_letter_code": "CU"
}, {
"country": "Curaçao",
"two_letter_code": "CW"
}, {
"country": "Cyprus",
"two_letter_code": "CY"
}, {
"country": "Czechia",
"two_letter_code": "CZ"
}, {
"country": "Denmark",
"two_letter_code": "DK"
}, {
"country": "Djibouti",
"two_letter_code": "DJ"
}, {
"country": "Dominica",
"two_letter_code": "DM"
}, {
"country": "Dominican Republic",
"two_letter_code": "DO"
}, {
"country": "Ecuador",
"two_letter_code": "EC"
}, {
"country": "Egypt",
"two_letter_code": "EG"
}, {
"country": "El Salvador",
"two_letter_code": "SV"
}, {
"country": "Equatorial Guinea",
"two_letter_code": "GQ"
}, {
"country": "Eritrea",
"two_letter_code": "ER"
}, {
"country": "Estonia",
"two_letter_code": "EE"
}, {
"country": "Eswatini",
"two_letter_code": "SZ"
}, {
"country": "Ethiopia",
"two_letter_code": "ET"
}, {
"country": "Falkland Islands (Malvinas)",
"two_letter_code": "FK"
}, {
"country": "Faroe Islands",
"two_letter_code": "FO"
}, {
"country": "Fiji",
"two_letter_code": "FJ"
}, {
"country": "Finland",
"two_letter_code": "FI"
}, {
"country": "France",
"two_letter_code": "FR"
}, {
"country": "French Guiana",
"two_letter_code": "GF"
}, {
"country": "French Polynesia",
"two_letter_code": "PF"
}, {
"country": "French Southern Territories",
"two_letter_code": "TF"
}, {
"country": "Gabon",
"two_letter_code": "GA"
}, {
"country": "Gambia",
"two_letter_code": "GM"
}, {
"country": "Georgia",
"two_letter_code": "GE"
}, {
"country": "Germany",
"two_letter_code": "DE"
}, {
"country": "Ghana",
"two_letter_code": "GH"
}, {
"country": "Gibraltar",
"two_letter_code": "GI"
}, {
"country": "Greece",
"two_letter_code": "GR"
}, {
"country": "Greenland",
"two_letter_code": "GL"
}, {
"country": "Grenada",
"two_letter_code": "GD"
}, {
"country": "Guadeloupe",
"two_letter_code": "GP"
}, {
"country": "Guam",
"two_letter_code": "GU"
}, {
"country": "Guatemala",
"two_letter_code": "GT"
}, {
"country": "Guernsey",
"two_letter_code": "GG"
}, {
"country": "Guinea",
"two_letter_code": "GN"
}, {
"country": "Guinea-Bissau",
"two_letter_code": "GW"
}, {
"country": "Guyana",
"two_letter_code": "GY"
}, {
"country": "Haiti",
"two_letter_code": "HT"
}, {
"country": "Heard Island and McDonald Islands",
"two_letter_code": "HM"
}, {
"country": "Holy See",
"two_letter_code": "VA"
}, {
"country": "Honduras",
"two_letter_code": "HN"
}, {
"country": "Hong Kong",
"two_letter_code": "HK"
}, {
"country": "Hungary",
"two_letter_code": "HU"
}, {
"country": "Iceland",
"two_letter_code": "IS"
}, {
"country": "India",
"two_letter_code": "IN"
}, {
"country": "Indonesia",
"two_letter_code": "ID"
}, {
"country": "Iran, Islamic Republic of",
"two_letter_code": "IR"
}, {
"country": "Iraq",
"two_letter_code": "IQ"
}, {
"country": "Ireland",
"two_letter_code": "IE"
}, {
"country": "Isle of Man",
"two_letter_code": "IM"
}, {
"country": "Israel",
"two_letter_code": "IL"
}, {
"country": "Italy",
"two_letter_code": "IT"
}, {
"country": "Jamaica",
"two_letter_code": "JM"
}, {
"country": "Japan",
"two_letter_code": "JP"
}, {
"country": "Jersey",
"two_letter_code": "JE"
}, {
"country": "Jordan",
"two_letter_code": "JO"
}, {
"country": "Kazakhstan",
"two_letter_code": "KZ"
}, {
"country": "Kenya",
"two_letter_code": "KE"
}, {
"country": "Kiribati",
"two_letter_code": "KI"
}, {
"country": "Korea, Democratic People's Republic of",
"two_letter_code": "KP"
}, {
"country": "Korea, Republic of",
"two_letter_code": "KR"
}, {
"country": "Kuwait",
"two_letter_code": "KW"
}, {
"country": "Kyrgyzstan",
"two_letter_code": "KG"
}, {
"country": "Lao People's Democratic Republic",
"two_letter_code": "LA"
}, {
"country": "Latvia",
"two_letter_code": "LV"
}, {
"country": "Lebanon",
"two_letter_code": "LB"
}, {
"country": "Lesotho",
"two_letter_code": "LS"
}, {
"country": "Liberia",
"two_letter_code": "LR"
}, {
"country": "Libya",
"two_letter_code": "LY"
}, {
"country": "Liechtenstein",
"two_letter_code": "LI"
}, {
"country": "Lithuania",
"two_letter_code": "LT"
}, {
"country": "Luxembourg",
"two_letter_code": "LU"
}, {
"country": "Macao",
"two_letter_code": "MO"
}, {
"country": "Madagascar",
"two_letter_code": "MG"
}, {
"country": "Malawi",
"two_letter_code": "MW"
}, {
"country": "Malaysia",
"two_letter_code": "MY"
}, {
"country": "Maldives",
"two_letter_code": "MV"
}, {
"country": "Mali",
"two_letter_code": "ML"
}, {
"country": "Malta",
"two_letter_code": "MT"
}, {
"country": "Marshall Islands",
"two_letter_code": "MH"
}, {
"country": "Martinique",
"two_letter_code": "MQ"
}, {
"country": "Mauritania",
"two_letter_code": "MR"
}, {
"country": "Mauritius",
"two_letter_code": "MU"
}, {
"country": "Mayotte",
"two_letter_code": "YT"
}, {
"country": "Mexico",
"two_letter_code": "MX"
}, {
"country": "Micronesia, Federated States of",
"two_letter_code": "FM"
}, {
"country": "Moldova, Republic of",
"two_letter_code": "MD"
}, {
"country": "Monaco",
"two_letter_code": "MC"
}, {
"country": "Mongolia",
"two_letter_code": "MN"
}, {
"country": "Montenegro",
"two_letter_code": "ME"
}, {
"country": "Montserrat",
"two_letter_code": "MS"
}, {
"country": "Morocco",
"two_letter_code": "MA"
}, {
"country": "Mozambique",
"two_letter_code": "MZ"
}, {
"country": "Myanmar",
"two_letter_code": "MM"
}, {
"country": "Namibia",
"two_letter_code": "NA"
}, {
"country": "Nauru",
"two_letter_code": "NR"
}, {
"country": "Nepal",
"two_letter_code": "NP"
}, {
"country": "Netherlands",
"two_letter_code": "NL"
}, {
"country": "New Caledonia",
"two_letter_code": "NC"
}, {
"country": "New Zealand",
"two_letter_code": "NZ"
}, {
"country": "Nicaragua",
"two_letter_code": "NI"
}, {
"country": "Niger",
"two_letter_code": "NE"
}, {
"country": "Nigeria",
"two_letter_code": "NG"
}, {
"country": "Niue",
"two_letter_code": "NU"
}, {
"country": "Norfolk Island",
"two_letter_code": "NF"
}, {
"country": "Northern Mariana Islands",
"two_letter_code": "MP"
}, {
"country": "North Macedonia",
"two_letter_code": "MK"
}, {
"country": "Norway",
"two_letter_code": "NO"
}, {
"country": "Oman",
"two_letter_code": "OM"
}, {
"country": "Pakistan",
"two_letter_code": "PK"
}, {
"country": "Palau",
"two_letter_code": "PW"
}, {
"country": "Palestine, State of",
"two_letter_code": "PS"
}, {
"country": "Panama",
"two_letter_code": "PA"
}, {
"country": "Papua New Guinea",
"two_letter_code": "PG"
}, {
"country": "Paraguay",
"two_letter_code": "PY"
}, {
"country": "Peru",
"two_letter_code": "PE"
}, {
"country": "Philippines",
"two_letter_code": "PH"
}, {
"country": "Pitcairn",
"two_letter_code": "PN"
}, {
"country": "Poland",
"two_letter_code": "PL"
}, {
"country": "Portugal",
"two_letter_code": "PT"
}, {
"country": "Puerto Rico",
"two_letter_code": "PR"
}, {
"country": "Qatar",
"two_letter_code": "QA"
}, {
"country": "Réunion",
"two_letter_code": "RE"
}, {
"country": "Romania",
"two_letter_code": "RO"
}, {
"country": "Russian Federation",
"two_letter_code": "RU"
}, {
"country": "Rwanda",
"two_letter_code": "RW"
}, {
"country": "Saint Barthélemy",
"two_letter_code": "BL"
}, {
"country": "Saint Helena, Ascension and Tristan da Cunha",
"two_letter_code": "SH"
}, {
"country": "Saint Kitts and Nevis",
"two_letter_code": "KN"
}, {
"country": "Saint Lucia",
"two_letter_code": "LC"
}, {
"country": "Saint Martin (French part)",
"two_letter_code": "MF"
}, {
"country": "Saint Pierre and Miquelon",
"two_letter_code": "PM"
}, {
"country": "Saint Vincent and the Grenadines",
"two_letter_code": "VC"
}, {
"country": "Samoa",
"two_letter_code": "WS"
}, {
"country": "San Marino",
"two_letter_code": "SM"
}, {
"country": "Sao Tome and Principe",
"two_letter_code": "ST"
}, {
"country": "Saudi Arabia",
"two_letter_code": "SA"
}, {
"country": "Senegal",
"two_letter_code": "SN"
}, {
"country": "Serbia",
"two_letter_code": "RS"
}, {
"country": "Seychelles",
"two_letter_code": "SC"
}, {
"country": "Sierra Leone",
"two_letter_code": "SL"
}, {
"country": "Singapore",
"two_letter_code": "SG"
}, {
"country": "Sint Maarten (Dutch part)",
"two_letter_code": "SX"
}, {
"country": "Slovakia",
"two_letter_code": "SK"
}, {
"country": "Slovenia",
"two_letter_code": "SI"
}, {
"country": "Solomon Islands",
"two_letter_code": "SB"
}, {
"country": "Somalia",
"two_letter_code": "SO"
}, {
"country": "South Africa",
"two_letter_code": "ZA"
}, {
"country": "South Georgia and the South Sandwich Islands",
"two_letter_code": "GS"
}, {
"country": "South Sudan",
"two_letter_code": "SS"
}, {
"country": "Spain",
"two_letter_code": "ES"
}, {
"country": "Sri Lanka",
"two_letter_code": "LK"
}, {
"country": "Sudan",
"two_letter_code": "SD"
}, {
"country": "Suriname",
"two_letter_code": "SR"
}, {
"country": "Svalbard and Jan Mayen",
"two_letter_code": "SJ"
}, {
"country": "Sweden",
"two_letter_code": "SE"
}, {
"country": "Switzerland",
"two_letter_code": "CH"
}, {
"country": "Syrian Arab Republic",
"two_letter_code": "SY"
}, {
"country": "Taiwan, Province of China",
"two_letter_code": "TW"
}, {
"country": "Tajikistan",
"two_letter_code": "TJ"
}, {
"country": "Tanzania, United Republic of",
"two_letter_code": "TZ"
}, {
"country": "Thailand",
"two_letter_code": "TH"
}, {
"country": "Timor-Leste",
"two_letter_code": "TL"
}, {
"country": "Togo",
"two_letter_code": "TG"
}, {
"country": "Tokelau",
"two_letter_code": "TK"
}, {
"country": "Tonga",
"two_letter_code": "TO"
}, {
"country": "Trinidad and Tobago",
"two_letter_code": "TT"
}, {
"country": "Tunisia",
"two_letter_code": "TN"
}, {
"country": "Turkey",
"two_letter_code": "TR"
}, {
"country": "Turkmenistan",
"two_letter_code": "TM"
}, {
"country": "Turks and Caicos Islands",
"two_letter_code": "TC"
}, {
"country": "Tuvalu",
"two_letter_code": "TV"
}, {
"country": "Uganda",
"two_letter_code": "UG"
}, {
"country": "Ukraine",
"two_letter_code": "UA"
}, {
"country": "United Arab Emirates",
"two_letter_code": "AE"
}, {
"country": "United Kingdom of Great Britain and Northern Ireland",
"two_letter_code": "GB"
}, {
"country": "United States of America",
"two_letter_code": "US"
}, {
"country": "United States Minor Outlying Islands",
"two_letter_code": "UM"
}, {
"country": "Uruguay",
"two_letter_code": "UY"
}, {
"country": "Uzbekistan",
"two_letter_code": "UZ"
}, {
"country": "Vanuatu",
"two_letter_code": "VU"
}, {
"country": "Venezuela, Bolivarian Republic of",
"two_letter_code": "VE"
}, {
"country": "Viet Nam",
"two_letter_code": "VN"
}, {
"country": "Virgin Islands, British",
"two_letter_code": "VG"
}, {
"country": "Virgin Islands, U.S.",
"two_letter_code": "VI"
}, {
"country": "Wallis and Futuna",
"two_letter_code": "WF"
}, {
"country": "Western Sahara",
"two_letter_code": "EH"
}, {
"country": "Yemen",
"two_letter_code": "YE"
}, {
"country": "Zambia",
"two_letter_code": "ZM"
}, {
"country": "Zimbabwe",
"two_letter_code": "ZW"
}, {
"country": "Åland Islands",
"two_letter_code": "AX"
}
],
"total_items": 249
}