---
title: "Get artist claim status"
method: GET
path: "/distribution/v1/artist/claim/{partner_user_id}"
tags: ["Claims"]
---

# Get artist claim status

`GET /distribution/v1/artist/claim/{partner_user_id}`

## Request

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

Returns the verified artist identifiers associated with a distributor user. Use this to confirm that a claim has been successfully processed.

## Path parameters

- `partner_user_id` string, required

## Query parameters

- `trustee` string, required

## Response `200`

Verified artist identifiers for the given distributor user.

- ArtistClaimStatusEnvelope
  - `message` string: Descriptive message of performed operation
  - `data` object
    - `artist_claim` object
      - `claim_id_list` object[]
        - `partner_artist_id` string
        - `partner_user_id` string
        - `itunes_artist_id` string
        - `spotify_artist_id` string

## Other responses

- `401`: Unauthorized — missing or invalid Bearer token
- `404`: Not found
- `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)