# List your connected users (docs picker)
URL: https://musicapi.com/docs/reference/list-docs-integration-users.md

`GET https://api.musicapi.com/public/docs-sessions/current/integration-users`

Section: Get started.
Product: MusicAPI Core and MusicAPI Managed Transfers.
Auth: DocsSession (any one of them). Use Basic with your Client ID and Client Secret from your server only.

The connected users of your account, newest first, 20 per page, without credentials. A sandbox session sees only the demo and sample users. A sandbox session bound to a connected account sees only that account.

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `integrationType` | string | no |  |
| `cursor` | string | no |  |

## Response 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `items` | object[] | yes |  |
| `items[].uuid` | uuid | yes |  |
| `items[].integrationType` | string | yes |  |
| `items[].name` | string \| null | yes |  |
| `items[].imageUrl` | string \| null | yes |  |
| `items[].createdAt` | date-time | yes |  |
| `nextCursor` | string \| null | yes | Send it as `cursor` for the next page. Null on the last page. |

```json
{
  "items": [
    {
      "uuid": "5b0c6f0e-2c8a-4d0e-9a51-7e3f1c2d9b44",
      "integrationType": "spotify",
      "name": "Mica Nowak",
      "imageUrl": "string",
      "createdAt": "2026-10-16T09:41:07.000Z"
    }
  ],
  "nextCursor": "string"
}
```

## Errors

- 401: `docsSessionEnded`: sign in again.

## Example

```bash
curl https://api.musicapi.com/public/docs-sessions/current/integration-users \
  -H "Authorization: DocsSession $MUSICAPI_DOCS_SESSION"
```