Skip to main content
GET
Get all assets
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

Authorization:
  • Required role: user or higher
Query Parameters:

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Query Parameters

Search term

type
enum<string>

Filter by asset type. Comma-separated for multiple.

Available options:
Audio,
Video,
Ringtone,
YouTube
explicit
enum<string>

Filter by content rating. Comma-separated for multiple.

Available options:
explicit,
clean
splits
boolean
default:false

Include splits

artist
string

Filter by artist uuids

statistics
boolean
default:false

Include assets stats

sort
enum<string>
default:createdAt

Field to sort by. Standard fields include any asset attribute (e.g., title, isrc, displayArtist, createdAt).

When statistics=true, additional sortable fields become available:

  • splits - Number of splits associated with the asset
  • products - Number of products containing this asset
  • count - Total stream/sales count from royalty data
  • royalty - Total royalty earnings
Available options:
updatedAt,
createdAt,
title,
isrc,
displayArtist,
type,
splits,
products,
count,
royalty
order
string

Sort order ('asc' or 'desc', default: 'desc')

attributes
string

Comma-separated list of attributes to include

size
integer
default:10

Items per page

page
integer
default:1

Page number

limit
integer
default:10

Items per page

hasArtists
enum<string>

Filter assets by artist linkage. true = assets with artists, false = assets without

Available options:
true,
false
hasSplits
enum<string>

Filter assets by splits. true = assets with splits configured, false = assets without

Available options:
true,
false

Response

List of assets retrieved successfully

totalItems
integer

Total number of assets matching the query

Example:

100

Assets
object[]

Array of asset objects (capitalized key from Sequelize)

totalPages
integer

Total number of pages

Example:

10

currentPage
integer

Current page number

Example:

1

filteredItems
integer

Number of items in the current response

Example:

10