Countries list is a REST service that gives access to an ISO-3166 formatted list of world countries. It is useful to present a country options list from any application.

Get the list of countries

To send a GET request to the REST API Countries list, you have to provide the content-type header application/vnd.ez.api.CountriesList+xml.
Note that cache request headers can be added but those aren't fully implemented yet in eZ Publish 5.0.

Resource: /api/ezp/v2/services/countries
Method: GET
Content-Type: application/vnd.ez.api.CountriesList+xml

See the General REST usage documentation page for further information.

Usage example


GET /api/ezp/v2/services/countries 
Accept: application/vnd.ez.api.CountriesList+xml


The HTTP response will it be with a 200 OK Header.

HTTP/1.1 200 
Content-Type: application/vnd.ez.api.CountriesList+xml


And the body of the Response is XML formatted countrly list with name and codes according to the ISO-3166 standard. 

The country codes can be represented either as a two-letter code (alpha-2) which is recommended as the general purpose code, a three-letter code (alpha-3) which is more closely related to the country name and a three digit numeric code (numeric -3) which can be useful if you need to avoid using Latin script.

See the ISO-3166 glossary for more information.


  <Country id="AF">
  <Country id="AX">