CHchartmetric
Venue

List Venues

List Chartmetric venues. Supports filtering by country (code2), Chartmetric city (cityId), venue type (venueType), venue name (search), and capacity range (minCapacity/maxCapacity), and sorting by name (default), capacity, or latestShowDate. Each venue includes its most recent show and the most popular artist on record to have performed there. By default the "latest show" only considers shows that have already happened; pass includeFutureShows=true to allow an upcoming show to be picked instead.

get/api/venue

Request

Query parameters

code2string

Filter to venues in this country (ISO 3166-1 alpha-2 code, e.g. 'US').

cityIdinteger

Filter to venues in this Chartmetric city.

minCapacityinteger

Filter to venues with a capacity greater than or equal to this value.

maxCapacityinteger

Filter to venues with a capacity less than or equal to this value.

venueType'stadium' | 'arena' | 'amphitheater' | 'festival' | 'theater' | 'concert_hall' | 'club'

Filter to venues of this type. One of stadium, arena, amphitheater, festival, theater, concert_hall, club.

searchstring

Filter to venues whose name contains this value (case-insensitive).

sortColumn'name' | 'capacity' | 'latestShowDate'

Column used to sort the venue list. One of name, capacity, latestShowDate. Defaults to name.

sortOrderDescboolean

If true, sort sortColumn in descending order. Defaults to false.

includeFutureShowsboolean

If true, a venue’s “latest show” may be an upcoming (future-dated) show. Defaults to false, which only considers shows that have already happened.

limitinteger

Maximum number of venues to return. Defaults to 20, max 100.

offsetinteger

Number of items to skip from the start of the result set; bounded by the public API offset limit.

Response

Success

Changes

No recorded changes to this operation across all 1 revision of this API.