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",
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "otherArtist": [
          "Featured Artist"
        ],
        "type": "Audio",
        "version": "Album Version",
        "isrc": "USRC17607839",
        "iswc": "T-123456789-0",
        "lyrics": "Waiting in a car...",
        "mainGenre": [
          "Electronic",
          "Synthpop"
        ],
        "subGenre": [
          "Synthwave"
        ],
        "contributors": {
          "producers": [
            "Producer Name"
          ],
          "mixers": [
            "Mixer Name"
          ],
          "songwriters": [
            "Songwriter Name"
          ]
        },
        "externalId": "EXT-12345",
        "extra": {
          "notes": "Recorded in Abbey Road Studios"
        },
        "metadata": {
          "releaseYear": 2011
        },
        "assetIDs": [
          "asset-1",
          "asset-2"
        ],
        "explicit": "clean",
        "label": "Royalti Records",
        "copyright": "© 2024 Royalti Records",
        "publisher": "Royalti Publishing",
        "copyrightOwner": "Royalti Music Group",
        "artists": [
          {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "type": "primary"
          },
          "660e8400-e29b-41d4-a716-446655440001"
        ],
        "split": [
          {
            "user": "550e8400-e29b-41d4-a716-446655440002",
            "share": 60
          },
          {
            "user": "550e8400-e29b-41d4-a716-446655440003",
            "share": 40
          }
        ],
        "ddexMetadata": {
          "releaseType": "Single",
          "recordLabel": "Royalti Records"
        },
        "resourceReference": "SR123456789",
        "technicalResourceDetails": {
          "fileFormat": "WAV",
          "audioCodec": "PCM",
          "bitrate": 1411,
          "sampleRate": 44100,
          "duration": "PT3M45S"
        },
        "soundRecordingDetails": {
          "recordingDate": "2024-01-15",
          "recordingLocation": "Abbey Road Studios",
          "language": "en"
        },
        "musicalWorkReference": {
          "workId": "work-123",
          "iswc": "T-123456789-0"
        },
        "enableDDEX": false,
        "focusTrack": false,
        "danceStyle": [
          "Electronic Dance"
        ],
        "rhythmStyle": [
          "Upbeat"
        ],
        "instrumentation": [
          "Synthesizer",
          "Drums"
        ],
        "recordingLocation": "Abbey Road Studios",
        "recordingDate": "2024-01-15",
        "alternativeTitles": [
          "Alt Title 1",
          "Alt Title 2"
        ],
        "chartPositions": [
          {
            "chart": "Billboard Hot 100",
            "position": 10,
            "date": "2024-01-01"
          }
        ],
        "reviews": [
          {
            "reviewer": "Music Magazine",
            "rating": 4.5,
            "text": "Great track!"
          }
        ],
        "awards": [
          {
            "name": "Best Electronic Song",
            "year": 2024
          }
        ],
        "socialMediaHandles": {
          "twitter": "@artistname",
          "instagram": "@artistname"
        },
        "language": "en",
        "mood": [
          "Energetic",
          "Uplifting"
        ],
        "tempo": 128,
        "key": "C Major",
        "productionYear": 2024
      }
    ],
    "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
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

Response

List of assets retrieved successfully

​
success
boolean
Example:

true

​
data
object