venues

Fetch a list of venues

Fetch a filtered, sorted, paginated list of venues

get/venues

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/venues
  • Auth: none declared

Query parameters

pageinteger

Page number for pagination (min: 1)

per_pageinteger

Number of items per page for pagination (min: 1, max: 1000)

latnumber float

Latitude for proximity search

lngnumber float

Longitude for proximity search

distancenumber float

Distance (in miles) for proximity search

audio_status'any' | 'complete' | 'partial' | 'missing' | 'complete_or_partial'

Filter by audio status: 'any' (default), 'complete', 'partial', 'missing', 'complete_or_partial'

sort'name:asc' | 'name:desc' | 'shows_count:asc' | 'shows_count:desc' | 'updated_at:asc' | 'updated_at:desc'

Sort by attribute and direction (e.g., 'name:asc')

first_char'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z' | '#'

Filter venues by the first character of the venue name (case-insensitive)

Response

Fetch a list of venues

idinteger required

ID of the venue

slugstring required

Unique slug identifier for the venue

namestring required

Name of the venue

other_namesstring[] required

Other names or aliases of the venue

latitudenumber float required

Latitude of the venue

longitudenumber float required

Longitude of the venue

citystring required

City where the venue is located

statestring required

State or region where the venue is located

countrystring required

Country where the venue is located

locationstring required

Full location of the venue (city, state, country)

map_snapshot_urlstring required

URL for venue map snapshot image

shows_countinteger required

Number of shows that have taken place at the venue

shows_with_audio_countinteger required

Number of shows that have taken place at the venue that have audio

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

Changes

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