Get Artists

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

GET /api/artists

cURL

cURL

curl --request GET \
  --url https://recoup-api.vercel.app/api/artists \
  --header 'x-api-key: <api-key>'

200

{
  "status": "success",
  "artists": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "image": "<string>",
      "pinned": true,
      "socials": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "platform": "<string>",
          "username": "<string>",
          "profile_url": "<string>"
        }
      ]
    }
  ],
  "message": "<string>"
}

Authorizations

x-api-key · string · header · required

Your Recoup API key. Learn more.

Query Parameters

accountId · string<uuid> · required

The account ID (required)

orgId · string<uuid>

Filter to artists in a specific organization

personal · enum<string>

Set to "true" to show only personal (non-org) artists

Available options: true

Response

200

application/json

Artists retrieved successfully

status · enum<string> · required

Status of the request

Available options: success, error

artists · object[] · required

List of artist objects

Show child attributes

message · string

Error message (only present if status is error)