shows

Fetch a list of shows

Fetch a filtered, sorted, paginated list of shows

get/shows

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/shows
  • 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

sort'date:asc' | 'date:desc' | 'likes_count:asc' | 'likes_count:desc' | 'duration:asc' | 'duration:desc' | 'updated_at:asc' | 'updated_at:desc'

Sort by attribute and direction (e.g., 'date:desc')

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

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

yearinteger

Filter shows by a specific year

year_rangestring

Filter shows by a range of years (e.g., '1987-1988')

venue_slugstring

Filter shows by the slug of the venue

tag_slugstring

Filter shows by the slug of an associated tag

start_datestring

Filter shows from this start date (inclusive)

end_datestring

Filter shows up to this end date (inclusive)

us_statestring

Filter shows by US state (abbreviations)

liked_by_userboolean

If true, fetch only those shows liked by the current user

Response

Fetch a list of shows

idinteger required

ID of the show

datestring date required

Date of the show

audio_statusstring required

Audio status of the show: 'complete', 'partial', or 'missing'

cover_art_urlsunknown required
album_cover_urlstring required

URL of album cover image (text overlayed on cover art)

cover_art_modelstring required

Identifier of the AI model that generated the cover art, if any

album_zip_urlstring required

URL of zipfile containing the show's MP3s, cover art, and taper notes

durationinteger required

Duration of the show in milliseconds. Excludes soundcheck (S) and pre-show (P) tracks.

admin_notesstring required

Administrator's notes related to the show

tour_namestring required

Name of the tour the show belongs to

venue_namestring required

Name of the venue where the show took place, reflecting the name at the time (not necessarily the current name)

taper_notesstring required

Notes from the taper of the show

likes_countinteger required

Number of likes the show has received

performance_gap_valueinteger required

The value to use when calculating song performance gaps (default 1). Some records in the database represent multiple shows that took place on the same date (>1) while others were performances that don't count toward gaps and personal stats (0).

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

tracksstring[]

Tracks associated with the show, included only on individual show requests

liked_by_userstring required
previous_show_datestring date required

Date of the previous show (including missing audio)

next_show_datestring date required

Date of the next show (including missing audio)

previous_show_date_with_audiostring date required

Date of the previous show that has audio (or last show that has audio if none exists)

next_show_date_with_audiostring date required

Date of the next show that has audio (or first show that has audio if none exists)

Changes

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