List Artists
Returns a paginated list of root artists for a project. Artists are extracted from contract documents and de-duplicated via merging.
Request
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|
projectId | UUID | Yes | — | The project to list artists for |
page | integer | No | 1 | Page number (1-indexed) |
perPage | integer | No | 20 | Items per page (1–100) |
includeMerged | string | No | false | Set to true to include merged artists for each root artist |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <token> — must be scoped to the requested project |
Response
{
"data": [
{
"id": "artist-1",
"name": "Adele",
"project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"merged": [
{ "id": "artist-2", "name": "Adele Adkins" }
]
}
]
}
The merged array only appears when includeMerged=true.
Errors
| Status | Description |
|---|
400 | Missing projectId or invalid query parameters |
403 | Token is not scoped to the requested project |
Example
curl "https://api.royaltyport.com/v1/artists?projectId=a1b2c3d4-...&page=1&perPage=50" \
-H "Authorization: Bearer rp_your_token_here"
Get Artist
Returns a single artist by ID.
Request
GET /v1/artists/{artist_id}
Path Parameters
| Parameter | Type | Required | Description |
|---|
artist_id | string | Yes | The artist ID |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|
projectId | UUID | Yes | — | The project the artist belongs to |
includeMerged | string | No | false | Set to true to include merged artists |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer <token> — must be scoped to the requested project |
Response
{
"data": {
"id": "artist-1",
"name": "Adele",
"project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"merged": [
{ "id": "artist-2", "name": "Adele Adkins" }
]
}
}
Errors
| Status | Description |
|---|
400 | Missing projectId |
403 | Token is not scoped to the requested project |
404 | Artist not found |
Example
curl "https://api.royaltyport.com/v1/artists/artist-1?projectId=a1b2c3d4-..." \
-H "Authorization: Bearer rp_your_token_here"
