# List someone's collections

`GET` `https://streetartcities.com/api/users/{userId}/collections`

Someone's public collections, or all of them if it's you.

## Path parameters

- **userId** `string` — required

## Requirements

Needs an [access token](/authentication/tokens/). When using OAuth, the token needs the [`collections:read`](/authentication/scopes/) scope.

## Responses

### `200` Their collections

- _Array of Collection_
  - **id** `string` — required
  - **createdBy** `string` — required
    The id of the person it belongs to
  - **name** `string`
  - **artworks** `array Artwork[]` — required
    - _Array of Artwork_
      - **id** `string` · min length: 1 — required
        The artwork's (marker's) id
      - **thumbnail** `string` · uri
        A link to a small image of it
  - **publicToken** `string`
    Set when the collection is public
  - **createdAt** `string`
  - **updatedAt** `string`

### `401` Not logged in, or not your collection

- **error** `object` — required
  - **message** `string` — required
  - **details** `array any[]`