# List all artists

### API Endpoint

```http
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)

```json
{
  "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"
    }
  ]
}
```
