API Methods
Account ...
Blogs ...
Bookings ...
CreditHistory ...
Dashboard ...
DirectCam ...
DirectChat ...
Email ...
FieldReport ...
Groups ...
HotLists ...
Interview ...
Lists ...
Movie ...
Newsfeed ...
PhoneChat ...
Pictures ...
Profile ...
Search ...
Tours ...
Webcam ...

Get Countries

This API operation returns a list of Countries and their associated CountryID. You can exclude specified countries.

URL / Endpoint

Need help with Postman?

GET /v1/lists/getCountries


ExcludeCountryIDs string Comma delimited string of CountryIDs. Countries to which the IDs pertain will be excluded. For example 134,154,161.

Request Information

HTTP Method / Verb

Parameters can be passed to this operation using the HTTP GET method by passing parameters over the query string of the URI.


The REST API uses HTTP request headers to determine what data type is returned or to authenticate the developer's API key. More information can be found in the overview section.


Your API-Key is required with every request and can be passed in as a header or a query-string parameter. Don't have an API-Key? Get one now.


GET method



Countries Array of aws:Country List of Countries.

Response Sample

The following example returns a shortened list of Countries.

        "CountryID": 58
        "CountryName": "Afghanistan"
        "CountryISO2": "AF"
        "CountryISO3": "AFG",
        "Nationality": "Afghan",
	"AgeVerificationRequired": false
        "CountryID": 108
        "CountryName": "Albania"
        "CountryISO2": "AL"
        "CountryISO3": "ALB",
        "Nationality": "Albanian",
	"AgeVerificationRequired": false
        "CountryID": 1
        "CountryName": "Algeria"
        "CountryISO2": "DZ"
        "CountryISO3": "DZA",
        "Nationality": "Algerian",
	"AgeVerificationRequired": false
        "CountryID": 212
        "CountryName": "American Samoa"
        "CountryISO2": "AS"
        "CountryISO3": "ASM",
        "Nationality": "American Samoan",
	"AgeVerificationRequired": false
<ArrayOfCountry xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <CountryName>American Samoa</CountryName>
        <Nationality>American Samoan</Nationality>