---
title: "Search for a city."
method: GET
path: "/1.0/search/cities"
tags: ["/1.0/search/cities"]
---

# Search for a city.

`GET /1.0/search/cities`

Search for a city.

## Query parameters

- `country` string
- `name` string
- `p` integer
- `state` string
- `stateCode` string

## Response `200`

Success

- JsonCities — A Result consisting of a list of cities.
  - `cities` JsonCity[] — result list of cities
    - `id` string — unique identifier
    - `name` string — the city's name, depending on the language valid values are e.g. <em>&quot;M&uuml;chen&quot;</em> or <em>Munich</em>
    - `stateCode` string — The code of the city's state. For most countries this is a two-digit numeric code, with which the state can be identified uniquely in the specific Country. The code can also be a String for other cities. Valid examples are <em>&quot;CA&quot;</em> or <em>&quot;02&quot;</em> which in turn get uniquely identifiable when combined with the state's country: <em>&quot;US.CA&quot;</em> for California, United States or <em>&quot;DE.02&quot;</em> for Bavaria, Germany For a complete list of available states (that aren't necessarily used in this database) is available in <a href= "http://download.geonames.org/export/dump/admin1CodesASCII.txt">a textfile on geonames.org</a>. Note that this code is only unique combined with the city's Country. The code alone is <strong>not</strong> unique.
    - `state` string — The name of city's state, e.g. <em>&quot;Bavaria&quot;</em> or <em>&quot;Florida&quot;</em>
    - `coords` JsonCoords — Coordinates of a point on the globe. Mostly used for Cities.
      - `long` number — The longitude part of the coordinates.
      - `lat` number — The latitude part of the coordinates.
    - `country` JsonCountry — This class represents a country on earth.
      - `code` string — The country's <a href= "http://www.iso.org/iso/english_country_names_and_code_elements" >ISO code</a>. E.g. <em>&quot;ie&quot;</em> for Ireland
      - `name` string — The country's name. Can be a localized name - e.g. <em>&quot;Austria&quot;</em> or <em>&quot;&Ouml;sterreich&quot;</em> for Austria if the German name was requested.
  - `total` number — the total amount of items matching the query
  - `page` number — the current page. starts at 1
  - `itemsPerPage` number — the amount of items you get per page

---

[API](https://skmtc.dev/setlist/apis/setlist-fm-api.md) · [All operations](https://skmtc.dev/setlist/apis/setlist-fm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/setlist/setlist-fm-api/revisions/16af169c0ca3/schema)