Artists

Generated artists operations.

GET/v1/artists/{id}/albumsRead artist albumread

Audience: Integrations · Native API
Authorization: API key or personal access token with the read scope, or a signed-in session
OpenAPI operation ID: get_artists_id_albums

Parameters

Name	In	Type
`id`required	path	`string`
`cursor`	query	`string`
`limit`	query	`integer`

Responses

200Successapplication/json

Example

{
  "albums": [
    {
      "albumArtist": "string",
      "albumArtistId": "id_8h2k4q",
      "homeActions": {
        "collection": true,
        "delete": true,
        "details": true,
        "download": true,
        "editMetadata": true,
        "favorite": true,
        "myList": true,
        "notInterested": true,
        "play": true,
        "played": true,
        "playlist": true,
        "queue": true,
        "rating": true,
        "refreshMetadata": true,
        "removeFromContinue": true,
        "selection": {
          "collection": true,
          "delete": true,
          "download": true,
          "edit": true,
          "favorite": true,
          "myList": true,
          "play": true,
          "playlist": true,
          "queue": true,
          "refresh": true,
          "watched": true
        },
        "state": {
          "containerRevision": 0,
          "favorite": true,
          "personalRevision": 0,
          "rating": 0,
          "watched": true,
          "watchlisted": true
        },
        "watched": true
      },
      "id": "id_8h2k4q",
      "libraryId": "id_8h2k4q",
      "posterUrl": "https://example.com/…",
      "providerMatchStatus": "string",
      "providerObservedAt": "2026-10-18T19:30:00Z",
      "providerReleaseCountry": "string",
      "providerReleaseDate": "string",
      "providerReleaseGroupId": "id_8h2k4q",
      "providerReleaseId": "id_8h2k4q",
      "role": "album",
      "title": "Fargo",
      "year": 0
    }
  ],
  "nextCursor": "eyJvIjoyMH0"
}

Schema

albumsarray of objectrequired
- albumArtiststringrequired
- albumArtistIdstringrequired
- homeActionsobject
  - collectionbooleanrequired
  - deletebooleanrequired
  - detailsbooleanrequired
  - downloadbooleanrequired
  - editMetadatabooleanrequired
  - favoritebooleanrequired
  - myListbooleanrequired
  - notInterestedboolean
  - playbooleanrequired
  - playedbooleanrequired
  - playlistbooleanrequired
  - queuebooleanrequired
  - ratingbooleanrequired
  - refreshMetadatabooleanrequired
  - removeFromContinueboolean
  - selectionobjectrequired
    collectionbooleanrequired
    deletebooleanrequired
    downloadbooleanrequired
    editbooleanrequired
    favoritebooleanrequired
    myListbooleanrequired
    playbooleanrequired
    playlistbooleanrequired
    queuebooleanrequired
    refreshbooleanrequired
    watchedbooleanrequired
  - stateobjectrequired
    containerRevisionintegerrequired
    favoritebooleanrequired
    personalRevisionintegerrequired
    ratingnumber | any | nullrequired
    watchedbooleanrequired
    watchlistedbooleanrequired
  - watchedbooleanrequired
- idstringrequired
- libraryIdstringrequired
- posterUrlstring
- providerMatchStatusstringrequired
- providerObservedAtstring
- providerReleaseCountrystring
- providerReleaseDatestring
- providerReleaseGroupIdstring
- providerReleaseIdstring
- rolestringone of "album", "ep", "single", "compilation", "appearance"
- titlestringrequired
- yearinteger
nextCursorstringrequired

defaultRequest refused or unavailableapplication/json

Example

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

Schema

errorobjectrequired
- codestringrequired
- messagestringrequired

Error codesinvalid_requestunauthorizednot_permittednot_foundinternaldatabase_busy

Example request

curl -X GET "http://127.0.0.1:32500/v1/artists/{id}/albums" \
  -H "Authorization: Bearer $PORTICO_API_KEY"