---
title: "Request a transcription"
method: POST
path: "/distribution/v1/transcriptions"
tags: ["Transcriptions"]
---

# Request a transcription

`POST /distribution/v1/transcriptions`

Triggers AI transcription of a track from the audio file previously delivered via the delivery flow. Musixmatch will generate plain-text lyrics and time-synced lyrics from the audio. Returns a `transcription_request_id` to track progress.

## Request body

- TranscriptionRequest
  - `musixmatch_user_id` string, required — The Musixmatch user ID obtained via token introspection
  - `isrc` string, required — International Standard Recording Code (ISRC) of the track to transcribe
  - `language` string — Expected language of the lyrics as an ISO 639-1 code (e.g. `en`, `es`, `fr`). Optional but recommended — improves transcription accuracy.

## Response `202`

Transcription request accepted.

- TranscriptionSubmitEnvelope
  - `message` string — Descriptive message of performed operation
  - `data` object
    - `transcription` object
      - `transcription_request_id` integer — Unique identifier for this transcription request, used to poll status
      - `status` 'pending' | 'progress' | 'success' | 'failure'

## Other responses

- `400` — Bad request — invalid or missing parameters
- `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)