getCollections
Returns all collections a user has access to.
Categories:
Opensubsonic:
http://your-server/rest/getCollections
Returns all collections a user has access to.
Parameters
| Parameter | Req. | OpenS. | Default | 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. |
Example
http://your-server/rest/getCollections.view?u=demo&p=demo&v=1.13.0&c=AwesomeClientName&f=jsonResult
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,
"validUntil": "2026-03-23T03:18:41+00:00"
},
{
"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
}
]
}
}| Field | Type | Req. | OpenS. | Details |
|---|---|---|---|---|
collections | Array of collection | Yes | The collections |