getCollections

Returns all collections a user has access to.

Opensubsonic:

Extension

http://your-server/rest/getCollections

Returns all collections a user has access to.

Parameters

Parameter	Req.	Comment
`username`	No	If specified, return collections for this user rather than for the authenticated user. The authenticated user must have admin role if this parameter is used.
`count`	No	The number of collections to return. If unset or set to a negative value, return all collections.
`offset`	No	The number of collections to skip.

Example

http://your-server/rest/getCollections.view?count=2&u=demo&p=demo&v=1.13.0&c=AwesomeClientName&f=json

Result

A subsonic-response element with a top-level collections array of collection elements on success.

{
  "subsonic-response": {
    "status": "ok",
    "version": "1.16.1",
    "type": "AwesomeServerName",
    "serverVersion": "0.1.3 (tag)",
    "openSubsonic": true,
    "collections": [
      {
        "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
      },
      {
        "id": "800000076",
        "name": "testcollection2",
        "comment" "this is another collection",
        "owner": "user",
        "public": false,
        "itemCount": 17,
        "created": "2026-03-16T03:18:41+00:00",
        "changed": "2026-03-16T03:18:41+00:00",
        "readonly": true
      }
    ],
    "totalCount": 10
  }
}

Field	Type	Req.	OpenS.	Details
`collections`	Array of `collection`	Yes		The collections.
`totalCount`	integer	Yes		The total number of collections a user has access to.

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