tracks

Fetch a list of tracks

Fetch a filtered, sorted, paginated list of tracks

get/tracks

Request

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

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

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

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

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

tag_slugstring

Filter tracks by the slug of the tag

song_slugstring

Filter tracks by the slug of the song

liked_by_userboolean

Filter by tracks liked by the current user

start_datestring

Filter tracks from shows starting from this date (inclusive)

end_datestring

Filter tracks from shows up to this date (inclusive)

yearinteger

Filter tracks from shows in a specific year

year_rangestring

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

Response

Fetch a list of tracks

idinteger required

ID of the track

slugstring required

Unique slug identifier for the track

titlestring required

Title of the track

positioninteger required

Position of the track in the setlist

durationinteger required

Duration of the track in milliseconds

jam_starts_at_secondinteger required

Second at which the jam section starts in the track

set_nameinteger required

Set number this track belongs to

exclude_from_statsboolean required

Whether this track should be excluded from performance gap and other stats calculations

likes_countinteger required

Number of likes the track has received

audio_statusstring required

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

mp3_urlstring required

URL to the MP3 file of the track

waveform_image_urlstring required

URL to the waveform image of the track

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

show_datestring date required

Date of the show that the track belongs to

show_cover_art_urlsunknown required
show_album_cover_urlunknown required
venue_slugstring required

Unique slug of the venue where the show took place

venue_namestring required

Name the venue where the show took place, reflecting the name used on the date of the show

venue_locationstring required

City and state where the venue of the show was located

songsstring[] required

Songs associated with the track

liked_by_userstring required

Changes

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