# Fetch room

**GET /v1/Rooms/{Sid}**


Video rooms with one or more participants

## Servers
- https://video.twilio.com: https://video.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **Sid** (string)
  The SID of the Room resource to fetch.



## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that Twilio created to identify the Room resource.
- **status** (string)

- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Room resource.
- **enable_turn** (boolean | null)
  Deprecated, now always considered to be true.
- **unique_name** (string | null)
  An application-defined string that uniquely identifies the resource. It can be used as a `room_sid` in place of the resource's `sid` in the URL to address the resource, assuming it does not contain any [reserved characters](https://tools.ietf.org/html/rfc3986#section-2.2) that would need to be URL encoded. This value is unique for `in-progress` rooms. SDK clients can use this name to connect to the room. REST API clients can use this name in place of the Room SID to interact with the room as long as the room is `in-progress`.
- **status_callback** (string(uri) | null)
  The URL Twilio calls using the `status_callback_method` to send status information to your application on every room event. See [Status Callbacks](https://www.twilio.com/docs/video/api/status-callbacks) for more info.
- **status_callback_method** (string(http-method) | null)
  The HTTP method Twilio uses to call `status_callback`. Can be `POST` or `GET` and defaults to `POST`.
- **end_time** (string(date-time) | null)
  The UTC end time of the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format.
- **duration** (integer | null)
  The duration of the room in seconds.
- **type** (string)

- **max_participants** (integer)
  The maximum number of concurrent Participants allowed in the room. 
- **max_participant_duration** (integer)
  The maximum number of seconds a Participant can be connected to the room. The maximum possible value is 86400 seconds (24 hours). The default is 14400 seconds (4 hours).
- **max_concurrent_published_tracks** (integer | null)
  The maximum number of published audio, video, and data tracks all participants combined are allowed to publish in the room at the same time. Check [Programmable Video Limits](https://www.twilio.com/docs/video/programmable-video-limits) for more details. If it is set to 0 it means unconstrained.
- **record_participants_on_connect** (boolean | null)
  Whether to start recording when Participants connect.
- **video_codecs** (array[string] | null)
  An array of the video codecs that are supported when publishing a track in the room.  Can be: `VP8` and `H264`.
- **media_region** (string | null)
  The region for the Room's media server.  Can be one of the [available Media Regions](https://www.twilio.com/docs/video/ip-addresses#media-servers).
- **audio_only** (boolean | null)
  When set to true, indicates that the participants in the room will only publish audio. No video tracks will be allowed.
- **empty_room_timeout** (integer)
  Specifies how long (in minutes) a room will remain active after last participant leaves. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed.
- **unused_room_timeout** (integer)
  Specifies how long (in minutes) a room will remain active if no one joins. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed.
- **large_room** (boolean | null)
  Indicates if this is a large room.
- **url** (string(uri) | null)
  The absolute URL of the resource.
- **links** (object(uri-map) | null)
  The URLs of related resources.


[Powered by Bump.sh](https://bump.sh)