Artists

Technical catalogue inventory for ingested artists with GET /v1/artists.

The artists endpoints expose technical catalogue inventory: performer and contributor rows your organisation has ingested, with MusiMap canonical ids and client-side identifiers from delivery.

Not catalogue search

Artist inventory answers what artists exist in my ingested catalogue? It is for known catalogue rows, not open-ended discovery. Use Catalogue search for MusiSearch track discovery, or contact the MusiMap team for advanced catalogue workflows.

Scope and access

  • GET /v1/artists lists artists visible in organisation-owned catalogues through your current API context.
  • In V1, inventory is scoped to the token's current catalogue context from /v1/me (catalog_id). An optional catalog_id query filter must match that context.
  • GET /v1/artists/{artist_id} uses the MusiMap artist UUID only. Client/source ids belong in the outer_id list filter.
  • OAuth scope: catalog.read. Request this scope when exchanging client credentials. Tenant and catalogue access is enforced on every call.
  • To read an artist from MusiMap Atlas, call GET /v1/artists/{artist_id}?source=musimap-atlas. Requires musimap-atlas.read and organisation entitlement musimap_atlas_read. See MusiMap Atlas.

List artists

curl "https://api.musimap.com/v1/artists?outer_id=qobuz_artist_123" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Supported list filters include:

  • outer_id — client/source-side identifier.
  • name — exact display name match (case-insensitive).
  • isni, ipi, source_record_key, delivery_id.
  • created_after, created_before, updated_after, updated_before.
  • page, page_size (1–100) for pagination.

List responses use the standard MusiMap paginated envelope inside data. See Pagination.

Typical response fields

Each artist summary in data.results includes:

  • id — MusiMap canonical artist UUID.
  • name — display name.
  • catalog_id, outer_id when present.
  • created_at, updated_at.

V1 returns a compact inventory shape. Rich contributor graphs or role breakdowns are not exposed on this surface.

Get one artist

curl "https://api.musimap.com/v1/artists/$MUSIMAP_ARTIST_UUID" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

For MusiMap Atlas items, pass source=musimap-atlas: 

curl "https://api.musimap.com/v1/artists/$MUSIMAP_ARTIST_UUID?source=musimap-atlas" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Detail responses use the same public summary fields as list rows in V1. Returns HTTP 404 when the artist does not exist or is outside your access scope.

  • Tracks — recording inventory.
  • Releases — album/product inventory.
  • Works — musical composition inventory.

Errors

Missing or invalid tokens return HTTP 401 with the MusiMap error envelope. Inaccessible artist ids return HTTP 404 with data.error_code: "not_found" so callers cannot infer cross-tenant existence.