---
title: "Get Conversion by ID"
method: GET
path: "/v1/byId"
---

# Get Conversion by ID

`GET /v1/byId`

Retrieve details of a conversion using `task_id` or `conversion_id`.

## Query parameters

- `conversionType` 'MUSIC_AI' | 'TEXT_TO_SPEECH' | 'VOICE_CONVERSION' | 'EXTRACTION' | 'COVER' | 'STEMS_SEPARATION' | 'VOCAL_EXTRACTION' | 'DENOISING' | 'DEECHO' | 'DEREVERB' | 'SOUND_GENERATOR' | 'AUDIO_TRANSCRIPTION' | 'AUDIO_SPEED_CHANGER' | 'AUDIO_MASTERING' | 'AUDIO_CUTTER' | 'REMIX' | 'FILE_CONVERT' | 'KEY_BPM_EXTRACTION' | 'AUDIO_TO_MIDI' | 'EXTEND' | 'INPAINT' | 'SING_OVER_INSTRUMENTAL' | 'LYRICS_GENERATOR', required
- `task_id` string
- `conversion_id` string

## Response `200`

Successful response

- object
  - `success` boolean
  - `conversion` object
    - `task_id` string
    - `conversion_id` string
    - `status` string
    - `status_msg` string
    - `audio_url` string
    - `conversion_cost` number
    - `title` string
    - `lyrics` string
    - `music_style` string
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/musicgpt/apis/musicgpt-api.md) · [All operations](https://skmtc.net/musicgpt/apis/musicgpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/musicgpt/musicgpt-api/versions/6753dccf4c5d/schema)