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

# Search for venues.

`GET /1.0/search/venues`

Search for venues.

## Query parameters

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

## Response `200`

Success

- JsonVenues — A Result consisting of a list of venues.
  - `venue` JsonVenue[] — result list of venues
    - `city` JsonCity — This class represents a city where Venues are located. Most of the original city data was taken from <a href="http://geonames.org/">Geonames.org</a>.
      - `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.
    - `url` string — the attribution url
    - `id` string — unique identifier
    - `name` string — the name of the venue, usually without city and country. E.g. <em>&quot;Madison Square Garden&quot;</em> or <em>&quot;Royal Albert Hall&quot;</em>
  - `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)