Retrieve an audio

Retrieve an audio in a project using its ID.



Path Parameters

project_id integer

This is the Project ID.

audio_id integer

This is the ID or external ID of the audio.

Body Parameters

api_key string

This is the API Key.


If you are using the API to both create and retrieve your audio, we advise including a unique external_id with your request that relates to the content. This will allow you to easily retrieve the audio when necessary using this same ID.


200: OK

Everything worked as expected.

  "id": 999,
  "external_id": "123-a",
  "state": "processed",
  "media": [
      "id": 999,
      "content_type": "mp3",
      "url": ""
  "deleted": false,
  "metadata" :{
    "key": string

400: Bad Request

The request was unacceptable, often due to missing a required parameter.

401: Unauthorized

No valid API key provided.

404: Not Found

The requested resource doesn't exist e.g. incorrect Project ID.

API Explorer

For example requests, responses and to test your API calls, use our API Explorer.