---
title: "Get a list of Programmable Video Rooms."
method: GET
path: "/v1/Video/Rooms"
tags: ["InsightsV1Room"]
---

# Get a list of Programmable Video Rooms.

`GET /v1/Video/Rooms`

Get a list of Programmable Video Rooms.

## Query parameters

- `RoomType` VideoRoomSummaryEnumRoomType[]
- `Codec` VideoRoomSummaryEnumCodec[]
- `RoomName` string
- `CreatedAfter` string, date-time
- `CreatedBefore` string, date-time
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `rooms` InsightsV1VideoRoomSummary[]
    - `account_sid` string, nullable — Account SID associated with this room.
    - `room_sid` string, nullable — Unique identifier for the room.
    - `room_name` string, nullable — Room friendly name.
    - `create_time` string, date-time, nullable — Creation time of the room.
    - `end_time` string, date-time, nullable — End time for the room.
    - `room_type` 'go' | 'peer_to_peer' | 'group' | 'group_small'
    - `room_status` 'in_progress' | 'completed'
    - `status_callback` string, uri, nullable — Webhook provided for status callbacks.
    - `status_callback_method` 'GET' | 'POST', http-method, nullable — HTTP method provided for status callback URL.
    - `created_method` 'sdk' | 'ad_hoc' | 'api'
    - `end_reason` 'room_ended_via_api' | 'timeout'
    - `max_participants` integer, nullable — Max number of total participants allowed by the application settings.
    - `unique_participants` integer, nullable — Number of participants. May include duplicate identities for participants who left and rejoined.
    - `unique_participant_identities` integer, nullable — Unique number of participant identities.
    - `concurrent_participants` integer, nullable — Actual number of concurrent participants.
    - `max_concurrent_participants` integer, nullable — Maximum number of participants allowed in the room at the same time allowed by the application settings.
    - `codecs` VideoRoomSummaryEnumCodec[], nullable — Codecs used by participants in the room. Can be `VP8`, `H264`, or `VP9`.
    - `media_region` 'us1' | 'us2' | 'au1' | 'br1' | 'ie1' | 'jp1' | 'sg1' | 'in1' | 'de1' | 'gll'
    - `duration_sec` integer, nullable — Total room duration from create time to end time.
    - `total_participant_duration_sec` integer, nullable — Combined amount of participant time in the room.
    - `total_recording_duration_sec` integer, nullable — Combined amount of recorded seconds for participants in the room.
    - `processing_state` 'complete' | 'in_progress' | 'timeout' | 'not_started'
    - `recording_enabled` boolean, nullable — Boolean indicating if recording is enabled for the room.
    - `edge_location` 'ashburn' | 'dublin' | 'frankfurt' | 'singapore' | 'sydney' | 'sao_paulo' | 'roaming' | 'umatilla' | 'tokyo'
    - `url` string, uri, nullable — URL for the room resource.
    - `links` object, nullable — Room subresources.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

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