Skip to content

Get all albums

GET
/api/v1/artists/{artistId}/albums

Get a list of all albums from a legendary Argentine Rock artist. You can add a new album using the POSTAdd a new album endpoint.

Parameters

Path Parameters

artistId*
Typeinteger
Required
Example1
Format"int64"

Query Parameters

limit

The number of items to return

Typeinteger
Examples
102050
Format"int64"
Default10
offset

The number of items to skip before starting to collect the result set

Typeinteger
Examples
123456
Format"int64"
Default0

Responses

Albums Found

The request was successful and returns a list of albums for the specified artist.

Response Format

The response includes:

  • A data array containing album objects
  • Pagination information for navigating through large collections

Note: If the artist has no albums, the data array will be empty but the request will still return a 200 status code.

application/json
JSON
{
"data": [
{
"id": 1,
"name": "La Máquina de Hacer Pájaros",
"year": 1976,
"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"
}
],
"meta": {
"limit": 10,
"offset": 0,
"total": 100,
"next": "/artists?limit=10&offset=10"
}
}

Playground

Variables
Key
Value

Samples

Powered by VitePress OpenAPI