Retrieve a song

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Retrieve a single song by its ID. The response is a JSON:API document: the song is in data, while the artists and audio files it references are in included.

The first resource in data.relationships.artists.data is the song's primary artist. The first resource in data.relationships.audio_files.data is its primary audio file. Use the relationship IDs to find the corresponding full resources in included.

The song's attributes.isrc is a 12-character International Standard Recording Code when the song has been released to digital streaming platforms; otherwise, it is null. See The song object for the full attribute reference.

Example request

curl "https://api.soundstripe.com/v1/songs/12622" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Accept: application/vnd.api+json"

Responses

A successful request returns 200 with the requested song, its related artists, and its related audio files. A missing or inaccessible song returns 404. Requests without a valid API key return 401; an expired, inactive, or unauthorized key returns 403. See Authentication and Errors for the shared error format.

Path Params
string
required

The song's ID

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/vnd.api+json