Skip to content

List a collection's tracks

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

GEThttps://api.aitronos.com/v1/music/{organization_id}/collections/{collection_id}/tracks

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.

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"

Response:

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
}