shows

Fetch a show by date

Fetch a specific show by its date, including associated tracks and tags

get/shows/{date}

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/shows/{date}
  • Auth: none declared

Path parameters

datestring required

Date in the format YYYY-MM-DD

Query parameters

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

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

Response

Fetch a show by date

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.