GET /releases
This endpoint retrieves releases with filtering, pagination, and sorting options.Query Parameters
- status: Filter by release status
- format: Filter by release format
- type: Filter by release type
- search: Search in title, displayArtist, or description
- page: Page number for pagination (default: 1)
- limit: Number of items per page (default: 20)
- sortBy: Field to sort by (default: updatedAt)
- sortOrder: Sort order (asc/desc, default: desc)
- includeStats: Include statistics in response
Authentication
This endpoint requires authentication. Include your bearer token in the Authorization header.Query Parameters
Parameter | Type | In | Required | Description |
---|---|---|---|---|
status | string | query | ❌ | Filter by release status |
format | string | query | ❌ | Filter by release format |
type | string | query | ❌ | Filter by release type |
search | string | query | ❌ | Search in title, displayArtist, or description |
page | integer | query | ❌ | Page number for pagination |
limit | integer | query | ❌ | Number of items per page |
sortBy | string | query | ❌ | Field to sort by |
sortOrder | string | query | ❌ | Sort order |
includeStats | boolean | query | ❌ | Include statistics in response |
Responses
✅ 200 - Success
⚠️ 401 - Unauthorized
❌ 500 - Internal Server Error
Tags
Release
Authorizations
JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"
Query Parameters
Filter by release status
Available options:
draft
, submitted
, under_review
, approved
, rejected
, completed
Filter by release format
Available options:
Single
, EP
, Album
, Compilation
, Soundtrack
, Live
, Remix
, Remaster
Filter by release type
Available options:
Audio
, Video
, Mixed
Search in title, displayArtist, or description
Page number for pagination
Number of items per page
Field to sort by
Sort order
Available options:
asc
, desc
Include statistics in response