---
title: "List rooms"
method: GET
path: "/rooms"
tags: ["Rooms"]
---

# List rooms

`GET /rooms`

## Request

- Base URL: `https://dataroom.corgi.com/api/v1`
- URL: `https://dataroom.corgi.com/api/v1/rooms`
- Auth: HTTP bearer

Rooms in your workspace, most-recently-updated first; trashed rooms are excluded. Each row carries a `_count` of files, members, and groups. Optional `?status=`. Scope: `datarooms:read`.

## Query parameters

- `status` 'DRAFT' | 'ACTIVE' | 'CLOSED'
- `cursor` string
- `take` integer

## Response `200`

A page of rooms

## Other responses

- `401`: Unauthenticated
- `403`: Insufficient scope

---

[API](https://skmtc.dev/corgi/apis/dataroom-api.md) - [All operations](https://skmtc.dev/corgi/apis/dataroom-api/llms.txt) - [OpenAPI document](https://skmtc.dev/corgi/apis/dataroom-api/revisions/73f75ef04a00?raw)