Skip to main content
GET
Get Artists

Description

/artist/ Description: The /artist/ endpoint retrieves a list of artists based on specified criteria. It allows filtering artists by name, external ID, and searching for artists using a keyword. Authorization:
  • Required role: user or higher
Method: GET Query Parameters:

Code Examples

Authorizations

Authorization
string
header
required

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

Query Parameters

artistName
string

Filter artists by their name

externalId
string

Filter artists by external ID

page
integer
default:1

Page number for pagination

size
integer
default:10

Number of items per page

catalog
boolean

Include catalog information

q
string

Search query

statistics
boolean

Include statistical data

sort
enum<string>
default:updatedAt

Field to sort by. Standard fields include any artist attribute (e.g., artistName, externalId, updatedAt).

When statistics=true, additional sortable fields become available:

  • assets - Number of assets associated with the artist
  • products - Number of products associated with the artist
  • count - Total stream/sales count from royalty data
  • royalty - Total royalty earnings
Available options:
updatedAt,
createdAt,
artistName,
externalId,
assets,
products,
count,
royalty
order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
attributes
string

Comma-separated list of attributes to include

column
string

Specific column to filter

user
string

Filter by user ID

hasDefaultSplits
enum<string>

Filter artists by default splits. true = artists with splits configured, false = artists without

Available options:
true,
false
hasUsers
enum<string>

Filter artists by user linkage. true = artists linked to users, false = artists not linked

Available options:
true,
false

Response

Success

success
boolean
data
object[]
pagination
object