Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
   eZ Publish 4.x / legacy

eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Skip to end of metadata
Go to start of metadata

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.

Countries list request

See the General REST usage documentation page for further information.

Usage example


Countries list request


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

Countries list response headers


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.


Body XML Response