crate.artistMaster(key, id)
artistMaster(key: string, id: string, opts?: RequestOptions): Promise<ArtistMasterResponse>Fetch one master (release-group) dossier addressed under its artist — the full rich contract (header, every signal section, artwork, provenance). The cluster- attached per-master grain: list ids from an artist dossier’s discography facet, then hand (key, id) here for the detail. Cluster-first integrity: if the master is unknown, credited to a different artist, or bound only via a homonym name over-merge, the response is the honest gap { present: false, note } — never another artist’s dossier, never a 404. Branch on present; when present, binding.observed flags an over-merged (unverified) binding.
| Endpoint | GET /api/v2/artist/{key}/master/{id} |
| Auth | key |
| Returns | ArtistMasterResponse |
| Retryable | yes |
| Idempotent | yes |
Example
Section titled “Example”const r = await crate.artistMaster(clusterId, '11772');if (r.present) console.log(r.master.header.title, r.binding.observed);Throws
Section titled “Throws”CrateAPIError— on a non-2xx response.