> ## Documentation Index
> Fetch the complete documentation index at: https://docs.musicgpt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Status Check

After performing a conversion via one of our API endpoints, you may want to check the progress or retrieve the final result. You can do this easily by calling our [**Get Conversion by ID**](/api-documentation/endpoint/getById) endpoint.

***

### Example Request

Use the following code to check the status of any conversion using its `task_id`:

```python theme={null}
import requests

url = "https://api.musicgpt.com/api/public/v1/byId"

querystring = {
  "conversionType": "MUSIC_AI",
  "task_id": "12345678-abcd-1234-efgh-567890abcdef"
}

headers = {
  "Authorization": "<api-key>"
}

response = requests.request("GET", url, headers=headers, params=querystring)
print(response.text)
```

> Select one among the following values for conversionType: <br /> <br />
> MUSIC\_AI, TEXT\_TO\_SPEECH, VOICE\_CONVERSION, <br />
> COVER, EXTRACTION, DENOISING, DEECHO, DEREVERB, <br />
> SOUND\_GENERATOR, AUDIO\_TRANSCRIPTION, AUDIO\_SPEED\_CHANGER, <br />
> AUDIO\_MASTERING, AUDIO\_CUTTER, REMIX, FILE\_CONVERT, <br />
> KEY\_BPM\_EXTRACTION, AUDIO\_TO\_MIDI, EXTEND, INPAINT, <br />
> SING\_OVER\_INSTRUMENTAL, LYRICS\_GENERATOR, STEMS\_SEPARATION, VOCAL\_EXTRACTION

***

### Example Response

```json theme={null}
{
  "success": true,
  "conversion": {
    "task_id": "12345678-abcd-1234-efgh-567890abcdef",
    "conversion_id": "87654321-dcba-4321-hgfe-098765fedcba",
    "status": "COMPLETED",
    "status_msg": "Conversion successful",
    "audio_url": "https://lalals.s3.amazonaws.com/audiofile.mp3",
    "conversion_cost": 1.25,
    "title": "Generated Song",
    "lyrics": "[Verse 1]...",
    "music_style": "Pop",
    "createdAt": "2025-01-01T12:00:00Z",
    "updatedAt": "2025-01-01T12:05:00Z"
  }
}
```

You’ll receive details including:

* `status`: Whether the conversion is **IN\_QUEUE**, **ERROR**, **COMPLETED**, or **FAILED**.
* `status_msg`: A message describing the state.
* `audio_url`: A direct link to your generated audio file if the status is completed.
* Additional metadata such as title, lyrics, style, timestamps, and cost.

***

### Where to Start

1. First, perform a conversion via the [Conversion Endpoints](/api-documentation/conversions/musicai).
2. Save the `task_id` you receive in the response.
3. Use the **Get By ID** endpoint to check the progress.

***

### Still Unsure?

No worries — head over to the [**Get Conversion by ID**](/api-documentation/endpoint/getById) endpoint and try it for yourself with your own `task_id`. It's the easiest way to confirm conversion status and get direct download access to your audio output!