Logo

Docs

Albums

Get Multiple Albums by OMM Id

Fetch one or more albums by OpenMusicMetadata id.

Endpoint

GET /albums

Endpoint reference: getAlbums

Required Query Parameter

NameDescriptionTypeExample
omm_idsComma-separated OpenMusicMetadata idsstringz913j3q5cqmeii0d,ab12cd34ef56gh78

omm_ids are generally CUID2 identifiers issued by OpenMusicMetadata.

Optional Query Parameters

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

NameValuesRequired
langlocale stringfalse
includeartists, tracksfalse
viewminimalfalse
view[albums]minimalfalse
view[artists]minimalfalse
view[songs]minimalfalse
limit[artists]1-25false
limit[tracks]1-25false

Responses

StatusContent TypeResponse
200 OKapplication/jsonAlbumListResponse
400 Bad Requestapplication/jsonErrorResponse

On this page