---
title: "Revoke a subscription"
method: DELETE
path: "/distribution/v1/subscriptions/{musixmatch_user_id}"
tags: ["Subscriptions"]
---

# Revoke a subscription

`DELETE /distribution/v1/subscriptions/{musixmatch_user_id}`

Removes the Musixmatch premium plan from a user when they unsubscribe on the distributor's platform.

## Path parameters

- `musixmatch_user_id` string, required

## Response `200`

Subscription revoked.

- SubscriptionEnvelope
  - `message` string — Descriptive message of performed operation
  - `data` object
    - `subscription` object
      - `musixmatch_user_id` string
      - `plan_id` string — Present when activating a subscription
      - `status` 'active' | 'revoked'

## Other responses

- `401` — Unauthorized — missing or invalid Bearer token
- `404` — Not found

---

[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)