songs

Fetch a list of songs

Fetch a filtered, sorted, paginated list of songs

get/songs

Request

  • Base URL: https://phish.in/api/v2
  • URL: https://phish.in/api/v2/songs
  • 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'title:asc' | 'title:desc' | 'tracks_count:asc' | 'tracks_count:desc' | 'updated_at:asc' | 'updated_at:desc'

Sort by attribute and direction (e.g., 'title: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 songs by the first character of the song title (case-insensitive)

Response

Fetch a list of songs

idinteger required

ID of the song

slugstring required

Unique slug identifier for the song

titlestring required

Title of the song

aliasstring required

Alias or alternate title of the song, if any

originalboolean required

Indicates if the song is an original composition

artiststring required

Artist associated with the song (if not original)

tracks_countinteger required

Number of tracks associated with the song

tracks_with_audio_countinteger required

Number of tracks associated with the song that have audio

created_atstring required

Timestamp of initial creation

updated_atstring required

Timestamp of most recent update

previous_performance_gapinteger

Count of shows since the last performance of the song

previous_performance_slugstring

Slug of the last performance of the song

next_performance_gapinteger

Count of shows until the next performance of the song

next_performance_slugstring

Slug of the next performance of the song

previous_performance_gap_with_audiointeger

Count of shows since the last performance of the song where audio is present

previous_performance_slug_with_audiostring

Slug of the last performance of the song where audio is present

next_performance_gap_with_audiointeger

Count of shows until the next performance of the song where audio is present

next_performance_slug_with_audiostring

Slug of the next performance of the song where audio is present

Changes

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