API REFERENCE

List Pro Artists (Admin)

On this page

GET/api/admins/artists/pro

Retrieve the deduplicated list of artist IDs owned by pro accounts. An account is "pro" when its email belongs to an enterprise domain or it has an active Stripe subscription. Admin-scoped: requires an admin-flagged API key because the response identifies paying customer accounts.

Authentication

x-api-key in header

Request

cURL

curl --request GET \
  --url 'https://api.recoupable.dev/api/admins/artists/pro' \
  --header 'x-api-key: YOUR_API_KEY'

Responses

200Pro artist IDs retrieved successfully

application/json

statusstring · enumrequired

Status of the request

Values: "success", "error"

artistsarray<string>required

List of artist IDs owned by pro accounts

Item properties

string

errorstring

Error message (only present if status is 'error')

401Unauthorized - missing or invalid authentication

No response body schema is specified.

403Forbidden - caller is authenticated but not admin-scoped

No response body schema is specified.

500Internal server error while fetching pro artists

application/json

statusstring · enumrequired

Status of the request

Values: "success", "error"

artistsarray<string>required

List of artist IDs owned by pro accounts

Item properties

string

errorstring

Error message (only present if status is 'error')

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download accounts.json

View operation source

json

{
  "description": "Retrieve the deduplicated list of artist IDs owned by pro accounts. An account is \"pro\" when its email belongs to an enterprise domain or it has an active Stripe subscription. Admin-scoped: requires an admin-flagged API key because the response identifies paying customer accounts.",
  "security": [
    {
      "apiKeyAuth": []
    }
  ],
  "responses": {
    "200": {
      "description": "Pro artist IDs retrieved successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ArtistsProResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized - missing or invalid authentication"
    },
    "403": {
      "description": "Forbidden - caller is authenticated but not admin-scoped"
    },
    "500": {
      "description": "Internal server error while fetching pro artists",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ArtistsProResponse"
          }
        }
      }
    }
  }
}