# City Search

This API endpoint offers a flexible way to retrieve information about cities by supporting search queries based on city names or UN/LOCODEs. 
It's designed to help users find detailed city data, including geographic coordinates and zip codes.

Note: Either the 'query' or 'unlocode' parameter must be present. However, 'unlocode' should be the only active option when both 'query' and 'unlocode' parameters are present.

Endpoint: GET /cities
Version: 1.0.0
Security: bearerAuth

## Query parameters:

  - `query` (string)
    Search query for city name. Format: [CityName],[StateCode]
    Example: "Ontario,CA"

  - `unlocode` (string)
    UN/LOCODE search parameter. This takes precedence over 'query' when both are present.
    Example: "USONT"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (integer)
    A unique identifier for the city
    Example: 115

  - `data.country` (string)
    The country where the city is located
    Example: "USA"

  - `data.full_name` (string)
    The full name of the city, including state and country
    Example: "Ontario, CA, USA"

  - `data.full_name_zipcode` (string)
    The city's full name, potentially intended for future use to include zip code
    Example: "Ontario, CA, USA"

  - `data.zipcodes` (array)
    An array of zip codes associated with the city
    Example: ["91761","91762","91764"]

  - `data.name` (string)
    The name of the city
    Example: "Ontario"

  - `data.state` (string)
    The state or region where the city is located
    Example: "CA"

  - `data.alias` (string,null)
    An alternative name or alias for the city, if any

  - `data.latitude` (number)
    The city's geographic latitude
    Example: 34.0631

  - `data.longitude` (number)
    The city's geographic longitude
    Example: -117.6197


## Response 401 fields