---
title: "Get all rooms"
method: GET
path: "/v2/rooms"
tags: ["Room"]
---

# Get all rooms

`GET /v2/rooms`

Get a list of rooms.

## Query parameters

- `offset` integer
- `limit` integer
- `from` string, date-time
- `to` string, date-time
- `recording` 'none' | 'manual' | 'automatic'
- `call_type` 'audio_only' | 'audio_upgradable' | 'audio_video'
- `live` boolean
- `status` 'NOT_RUNNING' | 'RUNNING' | 'CLOSED'
- `disabled` boolean
- `user_id` string

## Response `200`

return list of Rooms

- object
  - `offset` integer — The number of items to skiped before starting to collect the result set.
  - `limit` integer — The numbers of items to returned.
  - `has_more` boolean — Indicates is there more values.
  - `count` integer — Total number of values returned.
  - `rooms` object[]
    - `id` string — Room id.
    - `recording` 'none' | 'manual' | 'automatic' — Type of recording.
    - `call_type` 'audio_only' | 'audio_upgradable' | 'audio_video' — Call type.
    - `description` string — Room description. **This field is treated as PII/PHI**
    - `status` 'NOT_RUNNING' | 'RUNNING' | 'CLOSED' — Status of the room.
    - `disabled` boolean — Indicates if a room is disabled or not.
    - `creation_date` string, date-time — Creation date of the room.
    - `duration` integer — Duration of the room.
    - `live` boolean — Indicates if the room is live or not.
    - `offline_transcription` boolean — Indicates if the room has transcription or not.
    - `summarization` boolean — Indicates if the room has summarization or not.

## Other responses

- `401` — Unauthorized
- `429` — Too Many request

---

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