Get Artists

Retrieve artists accessible to an account. Supports filtering by organization or showing only personal (non-organization) artists.

Endpoint

GET https://api.recoupable.com/api/artists

Parameters

Name	Type	Required	Description
accountId	string	Yes	The account ID
orgId	string	No	Filter to artists in a specific organization
personal	string	No	Set to `"true"` to show only personal (non-org) artists

Filtering Behavior

Parameters	Returns
`accountId` only	All artists (personal + all organizations)
`accountId` + `orgId=xyz`	Only artists in that specific organization
`accountId` + `personal=true`	Only personal artists (not in any org)

Request Examples

cURL

# Get all artists
curl -X GET "https://api.recoupable.com/api/artists?accountId=account-uuid" \
  -H "Content-Type: application/json"
 
# Get artists in a specific organization
curl -X GET "https://api.recoupable.com/api/artists?accountId=account-uuid&orgId=org-uuid" \
  -H "Content-Type: application/json"
 
# Get only personal artists (not in any org)
curl -X GET "https://api.recoupable.com/api/artists?accountId=account-uuid&personal=true" \
  -H "Content-Type: application/json"

Response Format

{
  "status": "success",
  "artists": [
    {
      "account_id": "artist-uuid-1",
      "name": "Mac Miller",
      "image": "https://example.com/mac.jpg",
      "pinned": true,
      "socials": [
        {
          "id": "social-uuid",
          "platform": "instagram",
          "username": "macmiller",
          "profile_url": "https://instagram.com/macmiller"
        }
      ]
    },
    {
      "account_id": "artist-uuid-2",
      "name": "Wiz Khalifa",
      "image": "https://example.com/wiz.jpg",
      "pinned": false,
      "socials": []
    }
  ]
}

Response Properties

Property	Type	Description
status	string	Status of the request ("success" or "error")
artists	array	List of artist objects
artists[].account_id	string	UUID of the artist account
artists[].name	string	Artist display name
artists[].image	string \| null	Artist profile image URL
artists[].pinned	boolean	Whether the account has pinned this artist
artists[].socials	array	Social media profiles linked to the artist
message	string	Error message (only present if status is "error")

Use Cases

Artist Sidebar: Show list of accessible artists in navigation
Organization View: Filter to show only artists managed by a specific org
Personal View: Show only artists not shared with any organization