---
title: "Get collections"
method: GET
path: "/api/v1/collections"
tags: ["collections"]
---

# Get collections

`GET /api/v1/collections`

Retrieve a paginated list of all collections visible to the API key.

    Personal API keys receive the key owner's virtual Private collection with ID `private`. Workspace API keys never receive private collections.

    This endpoint allows you to:
    - List all collections available to the current workspace
    - Paginate through large sets of collections
    - Use for collection pickers, dashboards, or management UIs

    **Use cases:**
    - Displaying available collections to users
    - Building collection management interfaces
    - Syncing collections with external tools

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

This response returns a paginated list of collections.

- object — This response returns a paginated list of collections.
  - `limit` number, required — The maximum number of items to return.
  - `offset` number, required — The number of items to skip before starting to collect the result set.
  - `hasNextPage` boolean, required — Indicates if there are more pages available.
  - `data` object[], required
    - `id` string, required
    - `isDefault` boolean
    - `workspace` string, required
    - `creator` string, required
    - `updater` string
    - `teams` string[], required
    - `created` string, date-time, required
    - `sortOrder` string
    - `name` string, required
    - `updated` string, date-time, required
    - `isDeleted` boolean
    - `emoji` object
      - `id` string, required
      - `native` string, required
      - `unified` string, required
    - `deletedAt` number

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)