# List a collection's tracks

List the tracks in a collection owned by the caller, in collection order (position ascending).

Returns a paginated list of ordered membership entries. Returns `404` if the collection is not owned by the caller.

## Path parameters

**`organization_id`** string required

The organization that owns the collection.

**`collection_id`** string required

The collection id (`mcoll_`).

## Query parameters

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

Maximum number of tracks to return. Must be between 1 and 500.

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

Number of tracks to skip for pagination.

## Returns

A paginated ordered-membership list.

**`collection_id`** string

The collection id these tracks belong to.

**`items`** array

Ordered membership entries (position ascending). Each entry has:

- **`track_id`** string — the member track id (`mtrack_`).
- **`position`** integer — the zero-based position of the track within the collection.
- **`added_at`** string — ISO 8601 timestamp the track was added.


**`limit`** integer

The applied page size.

**`offset`** integer

The applied offset.

Example

```bash cURL
curl "https://api.aitronos.com/v1/music/org_abc123/collections/mcoll_4a1f9c7e2b8d/tracks?limit=200&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/mcoll_4a1f9c7e2b8d/tracks",
    params={"limit": 200, "offset": 0},
)
for entry in page["items"]:
    print(entry["position"], entry["track_id"])
```


```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/mcoll_4a1f9c7e2b8d/tracks",
    headers={"X-API-Key": api_key},
    params={"limit": 200, "offset": 0},
)

for entry in response.json()["items"]:
    print(entry["position"], entry["track_id"])
```


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

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

const page = await response.json();
page.items.forEach(e => console.log(e.position, e.track_id));
```

**Response:**


```json 200 OK
{
  "collection_id": "mcoll_4a1f9c7e2b8d",
  "items": [
    {
      "track_id": "mtrack_8d2e1f6a3c9b",
      "position": 0,
      "added_at": "2026-06-28T10:35:00Z"
    },
    {
      "track_id": "mtrack_1b9c4e7f2a6d",
      "position": 1,
      "added_at": "2026-06-28T10:40:00Z"
    }
  ],
  "limit": 200,
  "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 404 Not Found
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "The requested resource was not found.",
    "system_message": "Music collection not found or not owned by caller",
    "type": "client_error",
    "status": 404,
    "details": { "collection_id": "mcoll_4a1f9c7e2b8d" },
    "trace_id": "req_jkl012abc",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

- [Reorder a collection](/docs/api-reference/music/reorder-collection)
- [Add a track to a collection](/docs/api-reference/music/add-collection-track)
- [Get a collection](/docs/api-reference/music/get-collection)