API resources: Countries

The Countries resource returns the list of countries available in MC Professional through the API.

Overview

The MC Professional API Country resource allows a 3rd party client to get the list of countries.

Get a list of countries

This resource returns the complete list of countries.

Scope

To access this resource, the access token must have the read scope.

Permissions

This resource is available to administrators.

Request

The request to get a list of countries is an HTTP GET to the /api/v1/country endpoint.  The following is the format of the request:

GET /api/v1/country HTTP/1.1
Host: <orgId>.memberclicks.net
Accept: application/json
Authorization: Bearer <accessToken>
Cache-Control: no-cache

• orgId: the MC Professional organization ID
• accessToken: the access token issued by the authorization server

Example

Using the example values below, the following is the resulting request:

• orgId: apiexample
• accessToken: eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0NjczMDczMDUsInVzZXJfbmFtZSI6IjEwMDEzNDU2MzAiLCJzY29wZSI6WyJyZWFkIl0sInNlcnZpY2VJZCI6NzM0MCwiYXV0aG9yaXRpZXMiOlsiUk9MRV9BRE1JTiIsIlJPTEVfRklOQU5DSUFMX0FETUlOIiwiUk9MRV9VU0VSIiwiUk9MRV9DTVNfQURNSU4iLCJST0xFX1BST0ZJTEVfSU1QT1JUX0FETUlOIiwiUk9MRV9QUk9GSUxFX0FETUlOIiwiUk9MRV9DT01NVU5JVFlfQURNSU4iLCJST0xFX01FTUJFUlNISVBfQURNSU4iLCJST0xFX0ZPUk1TX0FETUlOIiwiUk9MRV9SRVBPUlRJTkdfQURNSU4iXSwidXNlcklkIjoxMDAxMzQ1NjMwLCJqdGkiOiIxODUxYjY0Yy1lNDdkLTRhMzAtYTE1NS02YmQ1NTFkMDI1YzQiLCJjbGllbnRfaWQiOiI4WmdaeFY5QjhyZHdWWEo4bHp1aCJ9.DVUJWPaq29rB_ApqPyWV1wYR1exAgkPFwytVyRH_Pk4

GET /api/v1/country HTTP/1.1
Host: apiexample.memberclicks.net
Accept: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0NjczMDczMDUsInVzZXJfbmFtZSI6IjEwMDEzNDU2MzAiLCJzY29wZSI6WyJyZWFkIl0sInNlcnZpY2VJZCI6NzM0MCwiYXV0aG9yaXRpZXMiOlsiUk9MRV9BRE1JTiIsIlJPTEVfRklOQU5DSUFMX0FETUlOIiwiUk9MRV9VU0VSIiwiUk9MRV9DTVNfQURNSU4iLCJST0xFX1BST0ZJTEVfSU1QT1JUX0FETUlOIiwiUk9MRV9QUk9GSUxFX0FETUlOIiwiUk9MRV9DT01NVU5JVFlfQURNSU4iLCJST0xFX01FTUJFUlNISVBfQURNSU4iLCJST0xFX0ZPUk1TX0FETUlOIiwiUk9MRV9SRVBPUlRJTkdfQURNSU4iXSwidXNlcklkIjoxMDAxMzQ1NjMwLCJqdGkiOiIxODUxYjY0Yy1lNDdkLTRhMzAtYTE1NS02YmQ1NTFkMDI1YzQiLCJjbGllbnRfaWQiOiI4WmdaeFY5QjhyZHdWWEo4bHp1aCJ9.DVUJWPaq29rB_ApqPyWV1wYR1exAgkPFwytVyRH_Pk4
Cache-Control: no-cache

Response

A successful request will return an HTTP status 200 OK with the response in the following format:

HTTP/1.1 200 OK

{
  "totalCount": <totalCount>,
  "countries": <countries>
}

• totalCount: the total count of countries
• countries: the array of countries.  Each object in the array contains the country name.

Example

The following is the response for the example request above:

HTTP/1.1 200 OK

{
  "totalCount": 252,
  "countries": [
    {
      "name": "Afghanistan"
    },
    {
      "name": "Albania"
    },
    {
      "name": "Algeria"
    },
    {
      "name": "American Samoa"
    },
    {
      "name": "Andorra"
    },
    {
      "name": "Angola"
    },
    {
      "name": "Anguilla"
    },
    {
      "name": "Antarctica"
    },
    {
      "name": "Antigua and Barbuda"
    },
    {
      "name": "Argentina"
    },
    {
      "name": "Armenia"
    },
    {
      "name": "Aruba"
    },
    {
      "name": "Australia"
    },
    {
      "name": "Austria"
    },
    {
      "name": "Azerbaijan"
    },
    {
      "name": "Bahamas"
    },
    {
      "name": "Bahrain"
    },
    {
      "name": "Bangladesh"
    },
    {
      "name": "Barbados"
    },
    {
      "name": "Belarus"
    },
    {
      "name": "Belgium"
    },
    {
      "name": "Belize"
    },
    {
      "name": "Benin"
    },
    {
      "name": "Bermuda"
    },
    {
      "name": "Bhutan"
    },
    {
      "name": "Bolivia"
    },
    {
      "name": "Bosnia and Herzegovina"
    },
    {
      "name": "Botswana"
    },
    {
      "name": "Bouvet Island"
    },
    {
      "name": "Brazil"
    },
    {
      "name": "British Indian Ocean Territory"
    },
    {
      "name": "Brunei Darussalam"
    },
    {
      "name": "Bulgaria"
    },
    {
      "name": "Burkina Faso"
    },
    {
      "name": "Burma"
    },
    {
      "name": "Burundi"
    },
    {
      "name": "Cambodia"
    },
    {
      "name": "Cameroon"
    },
    {
      "name": "Canada"
    },
    {
      "name": "Canton and Enderbury Islands"
    },
    {
      "name": "Cape Verde"
    },
    {
      "name": "Cayman Islands"
    },
    {
      "name": "Central African Republic"
    },
    {
      "name": "Chad"
    },
    {
      "name": "Chile"
    },
    {
      "name": "China"
    },
    {
      "name": "Christmas Island"
    },
    {
      "name": "Cocos (Keeling) Islands"
    },
    {
      "name": "Colombia"
    },
    {
      "name": "Comoros"
    },
    {
      "name": "Congo"
    },
    {
      "name": "Congo, the Democratic Republic of the"
    },
    {
      "name": "Cook Islands"
    },
    {
      "name": "Costa Rica"
    },
    {
      "name": "Cote D'Ivoire"
    },
    {
      "name": "Croatia (Hrvatska)"
    },
    {
      "name": "Cuba"
    },
    {
      "name": "Cyprus"
    },
    {
      "name": "Czech Republic"
    },
    {
      "name": "Democratic Yemen"
    },
    {
      "name": "Denmark"
    },
    {
      "name": "Djibouti"
    },
    {
      "name": "Dominica"
    },
    {
      "name": "Dominican Republic"
    },
    {
      "name": "Dronning Maud Land"
    },
    {
      "name": "East Timor"
    },
    {
      "name": "Ecuador"
    },
    {
      "name": "Egypt"
    },
    {
      "name": "El Salvador"
    },
    {
      "name": "Equatorial Guinea"
    },
    {
      "name": "Eritrea"
    },
    {
      "name": "Estonia"
    },
    {
      "name": "Ethiopia"
    },
    {
      "name": "Falkland Islands (Malvinas)"
    },
    {
      "name": "Faroe Islands"
    },
    {
      "name": "Fiji"
    },
    {
      "name": "Finland"
    },
    {
      "name": "France"
    },
    {
      "name": "France, Metropolitan"
    },
    {
      "name": "French Guiana"
    },
    {
      "name": "French Polynesia"
    },
    {
      "name": "French Southern Territories"
    },
    {
      "name": "Gabon"
    },
    {
      "name": "Gambia"
    },
    {
      "name": "Georgia"
    },
    {
      "name": "Germany"
    },
    {
      "name": "Ghana"
    },
    {
      "name": "Gibraltar"
    },
    {
      "name": "Greece"
    },
    {
      "name": "Greenland"
    },
    {
      "name": "Grenada"
    },
    {
      "name": "Guadeloupe"
    },
    {
      "name": "Guam"
    },
    {
      "name": "Guatemala"
    },
    {
      "name": "Guinea"
    },
    {
      "name": "Guinea, Bissau"
    },
    {
      "name": "Guyana"
    },
    {
      "name": "Haiti"
    },
    {
      "name": "Heard and Mc Donald Islands"
    },
    {
      "name": "Honduras"
    },
    {
      "name": "Hong Kong"
    },
    {
      "name": "Hungary"
    },
    {
      "name": "Iceland"
    },
    {
      "name": "India"
    },
    {
      "name": "Indonesia"
    },
    {
      "name": "Iran (Islamic Republic of)"
    },
    {
      "name": "Iraq"
    },
    {
      "name": "Ireland"
    },
    {
      "name": "Israel"
    },
    {
      "name": "Italy"
    },
    {
      "name": "Jamaica"
    },
    {
      "name": "Japan"
    },
    {
      "name": "Johnston Island"
    },
    {
      "name": "Jordan"
    },
    {
      "name": "Kazakstan"
    },
    {
      "name": "Kenya"
    },
    {
      "name": "Kiribati"
    },
    {
      "name": "Korea, Democratic People's Republic of"
    },
    {
      "name": "Korea, Republic of"
    },
    {
      "name": "Kuwait"
    },
    {
      "name": "Kyrgyzstan"
    },
    {
      "name": "Lao People's Democratic Republic"
    },
    {
      "name": "Latvia"
    },
    {
      "name": "Lebanon"
    },
    {
      "name": "Lesotho"
    },
    {
      "name": "Liberia"
    },
    {
      "name": "Libyan Arab Jamahiriya"
    },
    {
      "name": "Liechtenstein"
    },
    {
      "name": "Lithuania"
    },
    {
      "name": "Luxembourg"
    },
    {
      "name": "Macau"
    },
    {
      "name": "Macedonia"
    },
    {
      "name": "Madagascar"
    },
    {
      "name": "Malawi"
    },
    {
      "name": "Malaysia"
    },
    {
      "name": "Maldives"
    },
    {
      "name": "Mali"
    },
    {
      "name": "Malta"
    },
    {
      "name": "Marshall Islands"
    },
    {
      "name": "Martinique"
    },
    {
      "name": "Mauritania"
    },
    {
      "name": "Mauritius"
    },
    {
      "name": "Mayotte"
    },
    {
      "name": "Mexico"
    },
    {
      "name": "Micronesia, Federated States of"
    },
    {
      "name": "Midway Islands"
    },
    {
      "name": "Moldova, Republic of"
    },
    {
      "name": "Monaco"
    },
    {
      "name": "Mongolia"
    },
    {
      "name": "Montenegro"
    },
    {
      "name": "Montserrat"
    },
    {
      "name": "Morocco"
    },
    {
      "name": "Mozambique"
    },
    {
      "name": "Myanmar"
    },
    {
      "name": "Namibia"
    },
    {
      "name": "Nauru"
    },
    {
      "name": "Nepal"
    },
    {
      "name": "Netherlands"
    },
    {
      "name": "Netherlands Antilles"
    },
    {
      "name": "Neutral Zone"
    },
    {
      "name": "New Caledonia"
    },
    {
      "name": "New Zealand"
    },
    {
      "name": "Nicaragua"
    },
    {
      "name": "Niger"
    },
    {
      "name": "Nigeria"
    },
    {
      "name": "Niue"
    },
    {
      "name": "Norfolk Island"
    },
    {
      "name": "Northern Mariana Islands"
    },
    {
      "name": "Norway"
    },
    {
      "name": "Oman"
    },
    {
      "name": "Pacific Islands"
    },
    {
      "name": "Pakistan"
    },
    {
      "name": "Palau"
    },
    {
      "name": "Palestine, State of"
    },
    {
      "name": "Panama"
    },
    {
      "name": "Papua New Guinea"
    },
    {
      "name": "Paraguay"
    },
    {
      "name": "Peru"
    },
    {
      "name": "Philippines"
    },
    {
      "name": "Pitcairn Island"
    },
    {
      "name": "Poland"
    },
    {
      "name": "Portugal"
    },
    {
      "name": "Puerto Rico"
    },
    {
      "name": "Qatar"
    },
    {
      "name": "Reunion"
    },
    {
      "name": "Romania"
    },
    {
      "name": "Russian Federation"
    },
    {
      "name": "Rwanda"
    },
    {
      "name": "S. Georgia and S. Sandwich Isls."
    },
    {
      "name": "Saint Lucia"
    },
    {
      "name": "Saint Vincent/Grenadines"
    },
    {
      "name": "Samoa"
    },
    {
      "name": "San Marino"
    },
    {
      "name": "Sao Tome and Principe"
    },
    {
      "name": "Saudi Arabia"
    },
    {
      "name": "Senegal"
    },
    {
      "name": "Serbia"
    },
    {
      "name": "Seychelles"
    },
    {
      "name": "Sierra Leone"
    },
    {
      "name": "Singapore"
    },
    {
      "name": "Slovakia (Slovak Republic)"
    },
    {
      "name": "Slovenia"
    },
    {
      "name": "Solomon Islands"
    },
    {
      "name": "Somalia"
    },
    {
      "name": "South Africa"
    },
    {
      "name": "South Sudan"
    },
    {
      "name": "Spain"
    },
    {
      "name": "Sri Lanka"
    },
    {
      "name": "St. Helena"
    },
    {
      "name": "St. Kitts Nevis Anguilla"
    },
    {
      "name": "St. Pierre and Miquelon"
    },
    {
      "name": "Sudan"
    },
    {
      "name": "Suriname"
    },
    {
      "name": "Svalbard and Jan Mayen Islands"
    },
    {
      "name": "Swaziland"
    },
    {
      "name": "Sweden"
    },
    {
      "name": "Switzerland"
    },
    {
      "name": "Syrian Arab Republic"
    },
    {
      "name": "Taiwan"
    },
    {
      "name": "Tajikistan"
    },
    {
      "name": "Tanzania, United Republic of"
    },
    {
      "name": "Thailand"
    },
    {
      "name": "Togo"
    },
    {
      "name": "Tokelau"
    },
    {
      "name": "Tonga"
    },
    {
      "name": "Trinidad and Tobago"
    },
    {
      "name": "Tunisia"
    },
    {
      "name": "Turkey"
    },
    {
      "name": "Turkmenistan"
    },
    {
      "name": "Turks and Caicos Islands"
    },
    {
      "name": "Tuvalu"
    },
    {
      "name": "Uganda"
    },
    {
      "name": "Ukraine"
    },
    {
      "name": "United Arab Emirates"
    },
    {
      "name": "United Kingdom"
    },
    {
      "name": "United States"
    },
    {
      "name": "United States Pacific Islands"
    },
    {
      "name": "Uruguay"
    },
    {
      "name": "US Minor Outlying Islands"
    },
    {
      "name": "Uzbekistan"
    },
    {
      "name": "Vanuatu"
    },
    {
      "name": "Vatican City State"
    },
    {
      "name": "Venezuela"
    },
    {
      "name": "Vietnam"
    },
    {
      "name": "Virgin Islands, British"
    },
    {
      "name": "Virgin Islands, US"
    },
    {
      "name": "Wake Island"
    },
    {
      "name": "Wallis and Futuma Islands"
    },
    {
      "name": "Western Sahara"
    },
    {
      "name": "Yemen"
    },
    {
      "name": "Zambia"
    },
    {
      "name": "Zimbabwe"
    }
  ]
}