---
title: "Get an audio file"
method: GET
path: "/audio/{id}"
tags: ["Audio"]
---

# Get an audio file

`GET /audio/{id}`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/audio/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

Read one audio file by media ID.

## Path parameters

- `id` string, uuid, required: Media ID.

## Response `200`

OK

- object
  - `data` object, required
    - `id` string, uuid, required: Media ID.
    - `type` string, required: Media family: image, video, or audio. More values may be added.
    - `source` string, required: How the file entered Rainbrand: uploaded, scraped (collected from a brand source), or generated. More values may be added.
    - `brandSessionId` string, uuid, required: Brand that owns the file.
    - `workspaceId` string, nullable, required: Workspace that owns the brand. Null for a personal workspace.
    - `mimeType` string, required: The file's MIME type.
    - `url` string, uri, required: Stable link to the file. Stops working when the file is deleted.
    - `fileSize` integer, required: Size in bytes.
    - `durationMs` integer, nullable, required: Duration in milliseconds, when known.
    - `width` integer, nullable, required: Width in pixels, when known.
    - `height` integer, nullable, required: Height in pixels, when known.
    - `description` string, nullable, required: Description of the file's contents, when Rainbrand has one.
    - `inLibrary` boolean, required: Whether the file is in its brand's Library.
    - `addedToLibraryAt` string, date-time, nullable, required: When the file was added to the Library, or null.
    - `generationId` string, uuid, nullable, required: Generation that produced the file, or null.
    - `createdAt` string, date-time, required: When the file was stored.

## Other responses

- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429

---

[API](https://skmtc.dev/rainbrand/apis/rainbrand-api.md) - [All operations](https://skmtc.dev/rainbrand/apis/rainbrand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rainbrand/apis/rainbrand-api/revisions/012b8e9da4df?raw)