# Get Audio

> Learn how to retrieve brand audio from your workspace

- **URL**: https://orshot.com/docs/api-reference/brand-audio-get

---

## Overview

This endpoint allows you to retrieve a list of brand audio tracks from your workspace. Brand audio can be reused across your video templates without uploading the same file every time.```markdown tab="Endpoint"
https://api.orshot.com/v1/brand-assets/audio/get
```## Query Parameters

| Parameter | Type   | Required | Description                                                                                     |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------------------- |
| `tag`     | String | No       | Comma-separated list of tags to filter by. Returns only audio that has **all** specified tags.  |

## Request```js
await fetch("https://api.orshot.com/v1/brand-assets/audio/get", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```js
await fetch("https://api.orshot.com/v1/brand-assets/audio/get?tag=intro,music", {
  method: "GET",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer <ORSHOT_API_KEY>",
  },
});
```</Tab>```json
{
  "data": [
    {
      "id": 42,
      "created_at": "2025-09-10T15:30:45.123Z",
      "name": "background-music.mp3",
      "original_filename": "background-music.mp3",
      "file_size": 2621440,
      "direct_url": "https://storage.orshot.com/cloud/w-50/renders/audio/background-music.mp3",
      "duration": 169.5,
      "format": "mp3",
      "mime_type": "audio/mpeg",
      "waveform_url": null,
      "metadata": {},
      "tags": ["intro", "music"],
      "workspace_id": 50,
      "user_id": "abcdef01-2345-6789-abcd-ef0123456789"
    }
  ]
}
```</Tab>
</Tabs>

## Rate Limits

- 30 requests per minute per endpoint

## Response Fields

| Field               | Type     | Description                               |
| ------------------- | -------- | ----------------------------------------- |
| `id`                | Number   | Unique identifier for the audio file      |
| `created_at`        | String   | Timestamp when the audio was uploaded     |
| `name`              | String   | Stored audio name                         |
| `original_filename` | String   | Display name of the uploaded audio        |
| `file_size`         | Number   | Size of the audio file in bytes           |
| `direct_url`        | String   | URL to access the audio                   |
| `duration`          | Number   | Audio duration in seconds                 |
| `format`            | String   | Audio format (e.g., `mp3`, `wav`)         |
| `mime_type`         | String   | MIME type of the audio                    |
| `waveform_url`      | String   | URL to a waveform image (may be `null`)   |
| `metadata`          | Object   | Custom metadata associated with the audio |
| `tags`              | String[] | Tags associated with the audio            |
| `workspace_id`      | Number   | ID of the workspace the audio belongs to  |
| `user_id`           | String   | ID of the user who uploaded the audio     |