---
title: "List collections"
method: GET
path: "/collections"
tags: ["Collections"]
---

# List collections

`GET /collections`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/collections`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Collections the caller can see: every collection in the projects they edit (in the X-WORKSPACE-ID workspace, when sent) plus every collection shared with them, from any workspace.

## Response `200`

Collections

- CollectionList
  - `collections` CollectionSummary[], required
    - `id` integer, required
    - `name` string, required
    - `description` string, nullable
    - `url` string, required
    - `project_id` integer, required
    - `workspace_id` integer, required
    - `role` string, required: 'manager' (edits its project) or 'member'
    - `dashboard_count` integer, required
    - `member_count` integer, nullable: Managers only — a member never sees the roster
    - `cover_url` string, nullable: The first published board's url token, for a thumbnail
    - `shared_by_name` string, nullable: Members only: who shared it with them
    - `has_refresh` boolean
    - `updated_at` string, date-time, nullable

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/5dfd1c296ded?raw)