---
title: "List albums"
method: GET
path: "/audio/albums"
tags: ["Audio catalogue"]
---

# List albums

`GET /audio/albums`

## Request

- Base URL: `https://michaelghelfistudios.com/api/v1`
- URL: `https://michaelghelfistudios.com/api/v1/audio/albums`
- Auth: none declared

Published albums (Patreon-only collections are not listed).

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Albums.

- object
  - `success` true
  - `data` object[]
    - `id` string
    - `slug` string, nullable
    - `title` string
    - `description` string, nullable
    - `cover_url` string, nullable
    - `track_count` integer
    - `published_at` string, nullable
    - `url` string: Album page (redirects to the shop).
    - `embed_url` string: Iframe-able card.
    - `player_url` string: Iframe-able player with previews of every track.
  - `meta` object
    - `version` 'v1'
    - `lang` string
    - `total` integer: Items matching the query, ignoring pagination.
    - `limit` integer
    - `offset` integer
    - `license` object
      - `name` string
      - `url` string
      - `attribution` string
  - `links` object
    - `self` string
    - `docs` string

---

[API](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api.md) · [All operations](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/michaelghelfistudios/apis/mgs-toolbox-public-api/revisions/20d2b0932478?raw)