List all artists

API Endpoint

GET /artist
Host: api.audicient.com
Authorization: <API_KEY>:<API_SECRET>
enterprise-id: 100001

Authentication Requirements

All requests must include authentication credentials.

• Authorization Header: Pass the API key and secret as <API_KEY>:<API_SECRET>.

• Enterprise-ID Header: Required for impersonation when accessing user-specific data.

Query Parameters

Parameter	Type	Description	Default
orderByDescending	boolean	Whether to sort results in descending order (true or false).	true
orderByProperty	string	Property to sort by.	createdAt
pageSize	number	Number of items per page.	20
pageNumber	number	The page number to retrieve.	1
fromDate	string	Filter results from this date (ISO format).	optional
toDate	string	Filter results up to this date (ISO format).	optional
searchText	string	Search query to filter artists.	"" (empty string)

Response

Success Response (200 OK)

{
  "totalItemsCount": 1,
  "pageNumber": 1,
  "pageSize": 20,
  "items": [
    {
      "artistId": 123456,
      "enterpriseId": 987654,
      "tenantId": "abcd1234-ef56-7890-gh12-ijkl34567890",
      "name": "Example Artist",
      "description": "A sample artist description.",
      "imageId": null,
      "spotifyId": "spotify_abcdef",
      "appleId": "apple_123456",
      "audiomackId": "audiomack_7890",
      "createdAt": "2025-03-16T14:03:23.427Z",
      "updatedAt": "2025-03-16T14:03:23.427Z"
    }
  ]
}