---
title: "New releases"
method: GET
path: "/v1/releases/new"
tags: ["Releases"]
---

# New releases

`GET /v1/releases/new`

## Request

- Base URL: `https://api.sonovault.now`
- URL: `https://api.sonovault.now/v1/releases/new`
- Auth: API key in header `x-api-key`

Paginated feed of releases ordered by release date (newest first).

**Requires a paid plan**: the free tier returns `403` for this endpoint.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successful response

- object
  - `results` Release[], required: Releases across the catalog, 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)