# List music collections

List the caller's own music collections, newest first. Only collections owned by the caller are returned.

Returns a paginated list of the caller's collections. `track_count` is `null` in the list view; fetch a single collection with [Get a collection](/docs/api-reference/music/get-collection) for the populated count.

## Path parameters

**`organization_id`** string required

The organization that owns the collections.

## Query parameters

**`limit`** integer optional · Defaults to `50`

Maximum number of collections to return. Must be between 1 and 100.

**`offset`** integer optional · Defaults to `0`

Number of collections to skip for pagination.

## Returns

A paginated list object.

**`items`** array

Collection objects, newest first. Each item has `id`, `name`, `description`, `cover_track_id`, `cover_image_url`, `track_count` (`null` in this view), `created_at`, and `updated_at`.

**`limit`** integer

The applied page size.

**`offset`** integer

The applied offset.

Example

```bash cURL
curl "https://api.aitronos.com/v1/music/org_abc123/collections?limit=50&offset=0" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python SDK
from aitronos import Aitronos  # pip install aitronos-sdk

client = Aitronos(api_key="your-api-key")

page = client.get("/v1/music/org_abc123/collections", params={"limit": 50, "offset": 0})
for collection in page["items"]:
    print(collection["id"], collection["name"])
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/music/org_abc123/collections",
    headers={"X-API-Key": api_key},
    params={"limit": 50, "offset": 0},
)

for collection in response.json()["items"]:
    print(collection["name"])
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/music/org_abc123/collections?limit=50&offset=0', {
  headers: { 'X-API-Key': apiKey }
});

const page = await response.json();
page.items.forEach(c => console.log(c.id, c.name));
```

**Response:**


```json 200 OK
{
  "items": [
    {
      "id": "mcoll_4a1f9c7e2b8d",
      "name": "Focus Sessions",
      "description": "Instrumental tracks for deep work",
      "cover_track_id": null,
      "cover_image_url": null,
      "track_count": null,
      "created_at": "2026-06-28T10:30:00Z",
      "updated_at": "2026-06-28T10:30:00Z"
    }
  ],
  "limit": 50,
  "offset": 0
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "details": {},
    "trace_id": "req_abc123xyz",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to perform this action.",
    "system_message": "Missing USE_MUSIC_GENERATION capability",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_def456uvw",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

- [Create a music collection](/docs/api-reference/music/create-collection)
- [Get a collection](/docs/api-reference/music/get-collection)
- [Music Studio overview](/docs/api-reference/music/introduction)