Skip to main content
GET
/
artist
/
{id}
/
products
Get Artist Products
curl --request GET \
  --url https://server26-dot-royalti-project.uc.r.appspot.com/artist/{id}/products \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "prod-123",
    "upc": "123456789012",
    "title": "Album Title",
    "isDraft": false,
    "splitCount": 3,
    "count": 50000,
    "royalty": 4500.25,
    "Assets": [
      {
        "id": "asset-456",
        "isrc": "USABC1234567",
        "title": "Song Title",
        "version": "Album Version",
        "AssetProducts": {
          "Number": 1
        }
      }
    ],
    "Artists": [
      {
        "id": "456",
        "artistName": "Main Artist",
        "type": "primary"
      }
    ]
  }
]
artist//products Description:
The /artist/{id}/products endpoint retrieves all products associated with a specific artist, including related assets and statistics.
Method:
GET
Path Parameter:
ParameterTypeDescription
idstringThe unique identifier of the artist.
Response Includes:
  • Basic product information
  • Related assets (id, isrc, title, version, track number)
  • Split count (number of splits associated with the product)
  • Total play/stream count (from ProductStats)
  • Total royalties (from ProductStats)
  • Artist information including the type of association

Authentication

This endpoint requires authentication. Include your bearer token in the Authorization header.

Path Parameters

ParameterTypeInRequiredDescription
idstringpathāœ…Artist ID

Query Parameters

ParameterTypeInRequiredDescription
pageintegerqueryāŒPage number for pagination
sizeintegerqueryāŒNumber of products per page
typestringqueryāŒFilter by product type

Responses

āœ… 200 - Success

āš ļø 401 - Unauthorized

āš ļø 404 - Not Found

āŒ 500 - Internal Server Error

Tags

Artist

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Artist ID

Query Parameters

page
integer
default:1

Page number for pagination

size
integer
default:10

Number of products per page

type
string

Filter by product type

Response

Success

id
string

Unique identifier of the product

upc
string

UPC code of the product

title
string

Title of the product

isDraft
boolean

Whether the product is a draft

splitCount
integer

Number of splits associated with this product

count
number

Total play/stream count from ProductStats

royalty
number

Total royalties from ProductStats

Assets
object[]
Artists
object[]
⌘I