collectionWithItems

A collection with items, as returned by the getCollection endpoint.

Opensubsonic:

Extension

{
  "id": "800000075",
  "name": "testcollection",
  "owner": "user",
  "public": true,
  "created": "2026-03-16T03:18:41+00:00",
  "changed": "2026-03-16T03:18:41+00:00",
  "itemCount": 3,
  "readonly": true,
  "items": [
    {
      "song": {
        "id": "300000060",
        "parent": "200000002",
        "title": "BrownSmoke",
        "isDir": false,
        "isVideo": false,
        "type": "music",
        "albumId": "200000002",
        "album": "Colorsmoke EP",
        "artistId": "100000002",
        "artist": "Synthetic",
        "coverArt": "300000060",
        "duration": 304,
        "bitRate": 20,
        "bitDepth": 16,
        "samplingRate": 44100,
        "channelCount": 2,
        "userRating": 5,
        "averageRating": 5,
        "track": 4,
        "year": 2007,
        "genre": "Electronic",
        "size": 792375,
        "discNumber": 1,
        "suffix": "wma",
        "contentType": "audio/x-ms-wma",
        "path": "Synthetic/Synthetic_-_Colorsmoke_EP-20k217-2007/04-Synthetic_-_BrownSmokeYSBM20k22khS.wma"
      }
    },
    {
      "album": {
        "id": "200000021",
        "parent": "100000036",
        "album": "Forget and Remember",
        "title": "Forget and Remember",
        "name": "Forget and Remember",
        "isDir": true,
        "coverArt": "al-200000021",
        "songCount": 20,
        "created": "2021-07-22T02:09:31+00:00",
        "duration": 4248,
        "playCount": 0,
        "artistId": "100000036",
        "artist": "Comfort Fit",
        "year": 2005,
        "genre": "Hip-Hop"
      }
    },
    {
      "genre": {
        "value": "vaporwave",
        "songCount": 6,
        "albumCount": 1
      }
    }
  ]
}

Field	Type	Req.	Details
`id`	`string`	Yes	Id of the collection
`name`	`string`	Yes	Name of the collection
`comment`	`string`	No	A commnet
`owner`	`string`	No	Owner of the collection
`public`	`boolean`	No	Is the collection public
`itemCount`	`int`	Yes	number of items
`created`	`string`	Yes	Creation date [ISO 8601]
`changed`	`string`	Yes	Last changed date [ISO 8601]
`readonly`	`boolean`	No	If true the collection cannot be edited by the current user
`items`	Array of `collectionItem`	Yes	The list of items

When readonly is true, clients should hide or disable UI actions that modify the collection. This is useful for server-generated collections like smart collections, recommendations, or curated system lists. The value should reflect the current authenticated user’s access level. When omitted, clients should assume the collection is editable (false).

Last modified June 9, 2026: collections: drop allowedUser and validUntil (3889dd7)