Skip to main content
GET
/
asset
Get all assets
curl --request GET \
  --url https://api.royalti.io/asset \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "items": [
      {
        "title": "Midnight City",
        "mainArtist": [
          "M83",
          "M47"
        ],
        "displayArtist": "M83",
        "type": "Audio",
        "version": "Album Version",
        "isrc": "USRC17607839",
        "iswc": "T1234567890",
        "mainGenre": [
          "Electronic",
          "Mental"
        ],
        "subGenre": [
          "Synthwave"
        ],
        "explicit": false,
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "artists": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "primary"
          }
        ],
        "split": [
          {
            "user": "550e8400-e29b-41d4-a716-446655440002",
            "share": 100
          }
        ],
        "externalId": "<string>",
        "contributors": {
          "producers": [
            "<string>"
          ],
          "mixers": [
            "<string>"
          ]
        }
      }
    ],
    "total": 123,
    "page": 123,
    "limit": 123
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

Query Parameters:
ParameterTypeDescription
searchstringSearch term to filter assets
typestring
splitsboolean
artiststringfilter by artist uuids
statisticsbooleaninclude assets stats
sortstringField to sort by (default: ‘createdAt’)
orderstringSort order (‘asc’ or ‘desc’, default: ‘desc’)
attributesstringComma-separated list of attributes to include
sizenumberItems per page (default: 10)
pagenumberPage number (default: 1)
productstringInclude product id to filter assets

​
Code Examples

const response = await fetch('https://api.royalti.io/asset', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

const data = await response.json();
console.log(data);

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
search
string

Search term

​
type
string

Asset type

​
splits
boolean
default:false

Include splits

​
artist
string

Filter by artist uuids

​
statistics
boolean
default:false

Include assets stats

​
sort
string

Field to sort by (default: 'createdAt')

​
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

Response

List of assets retrieved successfully

​
success
boolean
Example:

true

​
data
object