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.

Query Parameters
  • code2
    Type: string
    min length:  
    2
    max length:  
    2

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

  • cityId
    Type: integer
    min:  
    0
    max:  
    2147483647

    Filter to venues in this Chartmetric city.

  • minCapacity
    Type: integer
    min:  
    0

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

  • maxCapacity
    Type: integer
    min:  
    0

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

  • venueType
    Type: string enum

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

    values
    • stadium
    • arena
    • amphitheater
    • festival
    • theater
    • concert_hall
    • club
  • search
    Type: string
    max length:  
    200

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

  • sortColumn
    Type: string enum

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

    values
    • name
    • capacity
    • latestShowDate
  • sortOrderDesc
    Type: boolean

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

  • includeFutureShows
    Type: boolean

    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.

  • limit
    Type: integer
    min:  
    1
    max:  
    100

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

  • offset
    Type: integer
    min:  
    0
    max:  
    100000

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

Responses
  • application/json
Request Example for get/api/venue
curl https://api.chartmetric.com/api/venue \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "data": [
      {
        "id": 1,
        "name": "Greek Theatre",
        "image_url": "https://www.jambase.com/wp-content/uploads/2015/06/greek-1480x832.jpg",
        "city": "Berkeley",
        "city_id": 5391959,
        "country": "US",
        "lat": 37.8726,
        "lng": -122.254,
        "capacity": 8500,
        "venue_type": "theater",
        "latest_show": {
          "date": "2016-07-28T00:00:00.000Z",
          "title": "Modest Mouse at Greek Theatre"
        },
        "biggest_artist": {
          "id": 20,
          "name": "Modest Mouse"
        }
      }
    ],
    "total": 1
  }
}

Success