Songs

Get a Song

Fetch a single song resource by id.

Endpoint

GET /songs/{id}

Endpoint reference: getSong

Use this endpoint when you already know the song id and want the canonical song resource.

What You Can Include

albums
artists
lyrics

Path Parameters

Name	Description	Type	Example
`id`	Song id	`string`	`song_123`

Query Parameters

Scoped parameters like view[...] and limit[...] can shape included relationships.

Name	Values	Required
`lang`	locale string	`false`
`include`	`albums`, `artists`, `lyrics`	`false`
`view`	`minimal`	`false`
`view[songs]`	`minimal`	`false`
`view[albums]`	`minimal`	`false`
`view[artists]`	`minimal`	`false`
`limit[albums]`	`1-25`	`false`
`limit[artists]`	`1-25`	`false`

Response Shape

Returns a single song resource wrapped in data.

The returned item may be:

a full Song
a minimal BaseSong if view=minimal is used

Responses

Status	Content Type	Response
`200 OK`	`application/json`	`SongResponse`
`404 Not Found`	`application/json`	`ErrorResponse`

Info Responses

Response wrappers returned by info endpoints.

Get All Songs

Browse songs from the songs endpoint.

On this page

What You Can Include

Path Parameters

Query Parameters