---
title: "Get collection by ID"
method: GET
path: "/api/v1/collections/{collectionId}"
tags: ["collections"]
---

# Get collection by ID

`GET /api/v1/collections/{collectionId}`

Retrieve detailed information about a specific collection by its ID.

    This endpoint returns all metadata for the collection, including its name and configuration.

    **Use cases:**
    - Displaying collection details in UI
    - Validating collection existence before creating scenes
    - Fetching collection metadata for integrations

## Path parameters

- `collectionId` string, required

## Response `200`

Default Response

- object
  - `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

- `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.
- `404` — This response indicates that the requested resource could not be found.

---

[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)