# Cities

This endpoint returns a list of city IDs and their names in the selected languages.

You can filter the results by location ID. For example, to retrieve the list of cities in the Netherlands, pass: {"country":"nl"}.
To retrieve the bulk list, call the endpoint with an empty request body.
The city IDs returned by this endpoint are used as input and output values in other Demand API endpoints.
If a city ID returned by another Demand API endpoint is not included in the bulk list, retrieve it by passing the ID in the city field, for example: {"city":900043160}. A city returned by an ID-specific request may not be included in the bulk list.

Endpoint: POST /common/locations/cities
Version: 3.2
Security: BearerAuth

## Header parameters:

  - `X-Affiliate-Id` (integer, required)
    Include here your Affiliate identifier number

## Request fields (application/json):

  - `airport` (string)
    A three-letter code that uniquely identifies an airport as defined by the International Air Transport Association (IATA). The full list can be obtained by calling  common/locations/airports.

  - `city` (integer)
    A signed integer number that uniquely identifies a city. The full list can be obtained by calling common/locations/cities.

  - `country` (string)
    A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling common/locations/countries.

  - `district` (integer)
    A signed integer number that uniquely identifies a district. Typically, districts define known areas within a city. The full list can be obtained by calling common/locations/districts.

  - `landmark` (integer)
    A signed integer number that uniquely identifies a relevant geographical landmark, like a monument or a natural attraction. The full list can be obtained by calling common/locations/landmarks.

  - `languages` (array)
    Example: ["en-us"]

  - `page` (string)
    Pagination token used to retrieve the next page of results. Obtained from next_page.

  - `region` (integer)
    A signed integer number that uniquely identifies a geographical region. Regions usually define official administrative areas within a country, but may also include multiple countries and in some cases un-official but popular designations for geographical areas. An example of a region that crosses multiple countries is the Alps in Europe. The full list can be obtained by calling common/locations/regions.

  - `rows` (integer)
    The maximum number of results to return.

## Response 200 fields (application/json):

  - `request_id` (string)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `data` (array)

  - `data.id` (integer)
    A signed integer number that uniquely identifies a city. The full list can be obtained by calling common/locations/cities.

  - `data.name` (object)
    A string localised in multiple languages.

  - `data.name.^[a-z]{2}(-[a-z]{2})$` (string,null)
    The content localised in this language.

  - `data.coordinates` (object)

  - `data.coordinates.latitude` (number)

  - `data.coordinates.longitude` (number)

  - `metadata` (object)

  - `metadata.next_page` (string,null)
    Indicates that more results are available. Use this pagination token to retrieve the next page of results (via parameter page).