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

# Claim an artist

`POST /distribution/v1/artist/claim`

## Request

- Base URL: `https://api.musixmatch.com`
- URL: `https://api.musixmatch.com/distribution/v1/artist/claim`
- Auth: API key in query parameter `apikey`
- TypeScript: <https://skmtc.dev/musixmatch/apis/lyrics-api/docs/distribution/v1/artist/claim/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/musixmatch/apis/lyrics-api.md) - [All operations](https://skmtc.dev/musixmatch/apis/lyrics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musixmatch/apis/lyrics-api/revisions/edbc169d5499?raw)