Skip to content

Get a music collection

Retrieve a single collection owned by the caller, including its populated track count.

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

Returns the collection with track_count populated. Returns 404 if the collection does not exist or is not owned by the caller (IDOR-safe — a non-owner and a non-existent collection are indistinguishable).

Path parameters

organization_id string required

The organization that owns the collection.

collection_id string required

The collection id (mcoll_).

Returns

The collection object with id, name, description, cover_track_id, cover_image_url, track_count (populated), created_at, and updated_at.

cURL
curl "https://api.aitronos.com/v1/music/org_abc123/collections/mcoll_4a1f9c7e2b8d" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "id": "mcoll_4a1f9c7e2b8d",
  "name": "Focus Sessions",
  "description": "Instrumental tracks for deep work",
  "cover_track_id": "mtrack_8d2e1f6a3c9b",
  "cover_image_url": null,
  "track_count": 12,
  "created_at": "2026-06-28T10:30:00Z",
  "updated_at": "2026-06-28T11:15:00Z"
}