List all audios

Returns a list of audios in a project. Limited to 50 audios per page.

Endpoint

GET https://app.speechkit.io/api/v3/projects/{project_id}/audio

Path Parameters

project_id integer

This is the Project ID.

Query Parameters

api_key string

This is the API Key.

period string

This is the period that the audios were created in e.g., daily, weekly, and all.

page integer

This is the page index.

Response

200: OK

Everything worked as expected.

[
  {
    "id": 123456,
    "external_id": "b123409-dca0-4c91-b160-a6123333ee1",
    "state": "processed",
    "media": [
      {
        "id": 123456,
        "content_type": "m3u8",
        "url": "https://speechkit-staging.s3.amazonaws.com/audio/projects/123/podcasts/123456/media/1.m3u8"
      },
      {
        "id": 123456,
        "content_type": "mp3",
        "url": "https://speechkit-staging.s3.amazonaws.com/audio/projects/123/podcasts/123456/media/1.mp3"
      }
    ],
    "deleted": false,
    "metadata" :{
      "key": string
    }
  },
  
  {
    "id": 123456,
    "external_id": "b123409-dca0-4c91-b160-a6123333ee1",
    "state": "processed",
    "media": [
      {
        "id": 123456,
        "content_type": "m3u8",
        "url": "https://speechkit-staging.s3.amazonaws.com/audio/projects/123/podcasts/123456/media/1.m3u8"
      },
      {
        "id": 123456,
        "content_type": "mp3",
        "url": "https://speechkit-staging.s3.amazonaws.com/audio/projects/123/podcasts/123456/media/1.mp3"
      }
    ],
    "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.