# Get a list of cities

Endpoint: GET /v1/cities
Version: 1.0.1
Security: bearer

## Header parameters:

  - `Accept` (string, required)
    e.g. application/vnd.api.v2+json
    Example: "application/vnd.api.v2+json"

  - `Content-Type` (string, required)
    application/json

  - `Authorization` (string, required)
    Bearer partner_token

## Query parameters:

  - `country_id` (number)
    Country ID to get cities from

  - `company_id` (number)
    Location ID. If passed, the city of the location will also be returned, regardless of whether it belongs to the specified country or not

## Response 200 fields (application/json):

  - `success` (boolean)
    Execution success status (true)
    Example: true

  - `data` (array)
    Array of objects with data
    Example: [{"id":2,"country_id":7,"title":"New York"},{"id":1040,"country_id":30,"title":"Belfast"},{"id":1201,"country_id":38,"title":"București"},{"id":1334,"country_id":31,"title":"Budapest"}]

  - `data.id` (number)
    City ID

  - `data.country_id` (number)
    Country ID

  - `data.title` (string)
    City name

  - `meta` (array)
    Metadata (empty array)
    Example: []

## Response 401 fields (application/json):

  - `success` (boolean)
    Response status.

  - `data` (object,null)
    Response data.

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: "Authentication needed."

## Response 403 fields (application/json):

  - `success` (boolean)
    Response status.

  - `data` (object,null)
    Response data.

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: "Access denied."

## Response 404 fields (application/json):

  - `success` (boolean)
    Response status.

  - `data` (object,null)
    Response data.

  - `meta` (object,array)
    Additional response data (empty object or empty array)