---
title: "Claim an artist"
method: POST
path: "/distribution/v1/artist/claim"
tags: ["Claims"]
---

# Claim an artist

`POST /distribution/v1/artist/claim`

Associates a Musixmatch user with one or more artist identities from an external service. Submit at least one artist identifier per item. Musixmatch returns a list of `claim_id`s confirming the association. Use `GET /distribution/v1/artist/claim/{partner_user_id}` to query the status of a claim.

## Request body

- ArtistClaimRequest
  - `musixmatch_user_id` string, required — The Musixmatch user ID obtained via token introspection
  - `partner_user_id` string — The partner's internal user identifier
  - `artist` object[], required — List of artist identifiers. At least one identifier per item is required.
    - `spotify_artist_id` string — Spotify artist ID
    - `itunes_artist_id` string — iTunes/Apple Music artist ID
    - `partner_artist_id` string — Distributor's internal artist identifier
  - `trustee` string, required — The trustee identifier representing the submitting partner

## Response `201`

Claim submitted.

- ArtistClaimEnvelope
  - `message` string — Descriptive message of performed operation
  - `data` object
    - `artist_claim` object
      - `claim_id_list` string[] — List of claim IDs, one per matched artist

## Other responses

- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — missing or invalid Bearer token
- `502` — Bad gateway — upstream service call failed or returned an unexpected response

---

[API](https://skmtc.net/musixmatch/apis/lyrics-api.md) · [All operations](https://skmtc.net/musixmatch/apis/lyrics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musixmatch/lyrics-api/revisions/edbc169d5499/schema)