---
title: "List items in a room"
method: GET
path: "/api/rooms/{code}/items"
tags: ["items"]
---

# List items in a room

`GET /api/rooms/{code}/items`

## Request

- Base URL: `https://useclippy.cc`
- URL: `https://useclippy.cc/api/rooms/{code}/items`
- Auth: none declared

## Path parameters

- `code` string, required

## Query parameters

- `since` integer

## Headers

- `X-Room-Password` string
- `X-Owner-Token` string

## Response `200`

Items listed (newest first, max 100)

- ItemListResponse
  - `room` string
  - `locked` boolean
  - `items` Item[]
    - `id` string, uuid
    - `text` string, nullable
    - `device` string, nullable
    - `createdAt` integer: Milliseconds since epoch.
    - `updatedAt` integer, nullable
    - `edited` boolean
    - `hasImage` boolean
    - `imageUrl` string, uri: Present when hasImage is true.
    - `imageMime` string: Present when hasImage is true.
    - `imageSize` integer: Bytes. Present when hasImage is true.
  - `now` integer: Server's current epoch ms; use as the next `?since` value.

## Other responses

- `401`: Room is password-protected

---

[API](https://skmtc.dev/useclippy/apis/clippy-api.md) · [All operations](https://skmtc.dev/useclippy/apis/clippy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useclippy/apis/clippy-api/revisions/9635a19d0ab8?raw)