# Retrieve list of cities

Fetch a comprehensive list of cities available within the PMS. The response includes details for each city, such as its name, unique identifier, address, facilities, and operational status. Optional query parameters can be used to filter the results by criteria such as location, status, or associated city. This endpoint is useful for managing property inventories and facilitating searches across multiple cities.

Endpoint: GET /api/v3/cities
Version: 3.0.4
Security: OAuth2

## Query parameters:

  - `cityName` (string)
    Name of the city to search for

  - `regionId` (integer)
    Id of the region to search for

  - `regionName` (string)
    Name of the region to search for

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)
    Unique identifier for the city

  - `content.regionName` (string)

  - `content.regionId` (integer)

  - `content.cityName` (string)
    Name of the city

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)

  - `page.number` (integer)