---
title: "Releases by label"
method: GET
path: "/v1/labels/{id}/releases"
tags: ["Releases"]
---

# Releases by label

`GET /v1/labels/{id}/releases`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/labels/{id}/releases`
- Auth: API key in header `x-api-key`

Paginated feed of releases on a specific label, ordered by release date (newest first). Each result carries the primary artist, label, catalog number, and track count. Add `from` and `until` to limit it to a date range; `from=2026-09-11&until=2026-09-11` lists what the label released that day.

## Path parameters

- `id` integer, required

## Query parameters

- `limit` integer
- `cursor` string
- `from` string
- `until` string

## Response `200`

Successful response

- object
  - `results` Release[], required: Releases on the label, newest first.
    - `id` integer, required: Release ID.
    - `title` string, required: Release title.
    - `artist` ArtistRef: A minimal artist reference. Artists are always nested objects on the public API, never a flat `artist_name` column.
      - `id` integer, required: Artist ID.
      - `name` string, required: Artist name.
    - `label` LabelRef, required: A minimal label reference.
      - `id` integer, required: Label ID.
      - `name` string, required: Label name.
    - `release_date` string, nullable, required: Release date, `YYYY-MM-DD`. `null` when unknown.
    - `catalog_no` string, nullable: The label's catalog number for the release. `null` when unknown.
    - `track_count` integer: Number of tracks on the release.
  - `next_cursor` string, nullable, required: Pass back as the `cursor` param for the next page. `null` on the last page.

---

[API](https://skmtc.dev/sonovault/apis/sonovault-api.md) · [All operations](https://skmtc.dev/sonovault/apis/sonovault-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonovault/apis/sonovault-api/revisions/0152fff23f2c?raw)