---
title: "List collections"
method: GET
path: "/v1/collection"
tags: ["Collections"]
---

# List collections

`GET /v1/collection`

## Request

- Base URL: `https://api.audiodelivery.net`
- URL: `https://api.audiodelivery.net/v1/collection`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Collections list.

- object
  - `ok` true, required
  - `api_request_id` string, uuid, required
  - `count` integer
  - `collections` Collection[]
    - `id` string, uuid
    - `creator_id` string, uuid
    - `organization_index` string
    - `title` string
    - `metadata` object
    - `theme` ImageColor[]
      - `hex` string
      - `area` number
      - `lightness` number
      - `saturation` number
    - `is_cover_overridable` boolean
    - `is_theme_overridable` boolean
    - `player_color` string
    - `player_color_light` string: Derived read-only variant of player_color adjusted to stay legible on a light background.
    - `player_color_dark` string: Derived read-only variant of player_color adjusted to stay legible on a dark background.
    - `player_subtitle` string

## Other responses

- `401`: Missing or invalid API key.

---

[API](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api.md) · [All operations](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audiodeliverynetwork/apis/audiodn-api/revisions/57d355fc6a44?raw)