Artists

The artists endpoints expose technical catalogue inventory for performers and contributors on Workspace (/v1/workspace/artists) and Atlas (/v1/atlas/artists).

Workspace and Atlas

• Workspace reads: OAuth scope catalog.read. Writes: OAuth scope catalog.write (POST list, PATCH detail).
• Atlas reads: OAuth scope atlas.read.
• Path ids are MusiMap artist UUIDs. Client ids belong in outer_id filters.
• No flat /v1/artists path and no entity delete.
• Request the OAuth scopes your integration needs when exchanging client credentials.

Catalogue context for Workspace follows client binding rules described in Catalogues. On detail GET, pass include for expansions; unknown tokens return HTTP 400. List endpoints do not support include.

List Workspace artists

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

Supported list filters include outer_id, name, isni, ipi, delivery identifiers, date windows, page, and page_size.

Identifier filters (outer_id, isni, ipi, and similar ids) use exact (normalized) match. name performs a case-insensitive substring match: name=Tartini matches Giuseppe Tartini. Leading and trailing whitespace is trimmed. Multiple filters combine with logical AND. Pagination applies after filters. A date window value that is not a real date matches nothing. Unsupported query parameters return HTTP 400.

Get one Workspace artist

curl "https://api.musimap.com/v1/workspace/artists/$MUSIMAP_ARTIST_UUID?include=names,references" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Path ids are MusiMap artist UUIDs. Client/source ids belong in the outer_id list filter.

Atlas artists

Browse and filter Atlas artists directly via /v1/atlas/artists (OAuth scope atlas.read). Use MusiSearch for relevance discovery, then retrieve the selected artist from its plane inventory endpoint when needed.

List Atlas artists

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

The example above returns every Atlas artist whose name contains Rivera, such as Ada Rivera.

Filter semantics match Workspace: identifiers are exact (normalized); name is a case-insensitive substring match; filters AND; pagination is post-filter; unsupported query parameters return HTTP 400.

Get one Atlas artist

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

Related inventory

• Tracks
• Releases
• Works
• Labels