---
title: "Get audio details"
method: GET
path: "/v1/audio-projects/{id}"
tags: ["Audio Projects"]
---

# Get audio details

`GET /v1/audio-projects/{id}`

Check the progress of a audio project. The `downloads` field is populated after a successful render.
  
**Statuses**
- `queued` — waiting to start
- `rendering` — in progress
- `complete` — ready; see `downloads`
- `error` — a failure occurred (see `error`)
- `canceled` — user canceled
- `draft` — not used

## Path parameters

- `id` string, required

## Response `200`

Success

- object — Success
  - `id` string, required — Unique ID of the audio. Use it with the [Get audio Project API](https://docs.magichour.ai/api-reference/audio-projects/get-audio-details) to fetch status and downloads.
  - `name` string, nullable, required — The name of the audio.
  - `status` 'draft' | 'queued' | 'rendering' | 'complete' | 'error' | 'canceled', required — The status of the audio.
  - `type` string, required — The type of the audio project. Possible values are VOICE_GENERATOR, VOICE_CHANGER, VOICE_CLONER, VIDEO_TO_AUDIO, MUSIC_GENERATOR
  - `created_at` string, date-time, required
  - `enabled` boolean, required — Whether this resource is active. If false, it is deleted.
  - `credits_charged` integer, required — The amount of credits deducted from your account to generate the audio. We charge credits right when the request is made. If an error occurred while generating the audio, credits will be refunded and this field will be updated to include the refund.
  - `downloads` object[], required
    - `url` string, uri, required
    - `expires_at` string, date-time, required
  - `error` object, nullable, required — In the case of an error, this object will contain the error encountered during video render
    - `message` string, required — Details on the reason why a failure happened.
    - `code` string, required — An error code to indicate why a failure happened.

## Other responses

- `400` — Invalid Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — Not Found

---

[API](https://skmtc.net/magichourhq/apis/magic-hour-api.md) · [All operations](https://skmtc.net/magichourhq/apis/magic-hour-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/magichourhq/magic-hour-api/versions/941298cfb29f/schema)