# List saved music tracks

List the authenticated user's music library — the tracks they have saved — newest save first. Optionally filter by mode, engine, or collection.

Playback URLs are omitted here to keep the list cheap — fetch a single track to mint a short-TTL signed URL.

## Path parameters

**`organization_id`** string required

The organization the library is scoped to. The caller must belong to it.

## Query parameters

**`mode`** string optional

Filter by generation mode (e.g. `creation` or `focus`).

**`engine`** string optional

Filter by internal engine key.

**`collection_id`** string optional

Restrict the library to the tracks in a specific collection (`mcoll_`-prefixed).

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

Maximum number of tracks to return (1–100).

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

Number of tracks to skip before this page.

## Returns

An object with the page of tracks and its pagination window.

**`items`** array · The caller's saved tracks for this page, newest save first.

**`limit`** integer · Maximum number of tracks returned in this page.

**`offset`** integer · Number of tracks skipped before this page.

Each track object contains:

**`id`** string · Track id (`mtrack_`-prefixed).

**`title`** string · Track title, if one was provided.

**`engine`** string · Internal engine key the track was generated with.

**`mode`** string · Generation mode the track was produced in.

**`measured_duration_seconds`** number · Measured master duration in seconds, if known.

**`instrumental`** boolean · Whether the track is instrumental-only.

**`licence_class`** string · Neutral licence tier: `commercial_cleared`, `commercial_enterprise`, `personal_only`, or `unclear`.

**`created_at`** string · When the track was created (UTC).

**`playback_url`** string · Always `null` in the list view.

**`stem_urls`** object · Always `null` in the list view.

Example

```bash cURL
curl "https://api.aitronos.com/v1/music/org_abc123/tracks?mode=creation&limit=20" \
  -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/tracks",
    params={"mode": "creation", "limit": 20},
)
for track in page["items"]:
    print(track["id"], track["title"])
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/music/org_abc123/tracks",
    headers={"X-API-Key": api_key},
    params={"mode": "creation", "limit": 20},
)
for track in response.json()["items"]:
    print(track["id"], track["title"])
```


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

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

const { items } = await response.json();
items.forEach(t => console.log(t.id, t.title));
```

**Response:**


```json 200 OK
{
  "items": [
    {
      "id": "mtrack_7c1a9e2f4b8d",
      "title": "Late Night Study",
      "engine": "studio",
      "mode": "creation",
      "measured_duration_seconds": 119.4,
      "instrumental": true,
      "licence_class": "personal_only",
      "created_at": "2026-06-28T10:31:00Z",
      "playback_url": null,
      "stem_urls": null
    }
  ],
  "limit": 20,
  "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 access this resource.",
    "system_message": "USE_MUSIC_GENERATION capability required",
    "type": "authorization_error",
    "status": 403,
    "details": {},
    "trace_id": "req_def456uvw",
    "timestamp": "2026-06-28T10:30:00Z"
  }
}
```

## Related Resources

- [Get a track](/docs/api-reference/music/get-track)
- [Save a track](/docs/api-reference/music/save-track)
- [List collections](/docs/api-reference/music/list-collections)
- [Create a generation job](/docs/api-reference/music/create-generation)