REST API: Rooms

Overview

The Programmable Video Rooms resource represents a communications session among multiple endpoints using one of Twilio's Programmable Video SDKs. Connected users (Participants) can share video and audio Tracks to the Room, and receive video and audio Tracks from other Participants in the Room.

The Rooms resource lets you dynamically create and complete Rooms and configure a Room's topology and behavior. Use this API to set Room properties such as its name, type, TURN configuration, webhook status callback URL, and the maximum number of Participants.

All Programmable Video REST API resources use the following base URL.

https://video.twilio.com

Contents

Room Instance Resource

Resource URI

/v1/Rooms/{RoomNameOrSid}

Resource Properties

Name Description
account_sid

The unique ID of the Account associated with this Room. (🏢 not PII)

date_created

The date that this resource was created, given as a UTC ISO 8601 Timestamp. (🏢 not PII)

date_updated

The date that this resource was last updated, given as a UTC ISO 8601 Timestamp. (🏢 not PII)

duration

The duration of the Room in seconds. (🏢 not PII)

enable_turn

Enable Twilio's Network Traversal TURN service. TURN service is used when direct peer-to-peer media connections cannot be established due to firewall restrictions. When used, TURN bandwidth usage is billed according to Network Traversal Service rates. This setting only applies to Rooms with type peer-to-peer. (🏢 not PII)

end_time

The end time of the Room, given as a UTC ISO 8601 Timestamp. (🏢 not PII)

max_participants

Maximum number of concurrent Participants allowed in the Room. peer-to-peer rooms can have a maximum of 10 Participants. (🏢 not PII)

media_region

Region for the media server in Group Rooms. See the available Media RegionsThis feature is not available in peer-to-peer rooms. (🏢 not PII)

record_participants_on_connect

Start recording when Participants connect. This feature is not available in peer-to-peer rooms. (🏢 not PII)

sid

A system-generated 34-character string that uniquely identifies this resource. (🏢 not PII)

status

A string representing the status of the Room. It can be one of in-progress, failed or completed. (🏢 not PII)

status_callback

A URL that Twilio sends asynchronous webhook requests to on every Room event. See Status Callbacks for details. (🏢 not PII)

status_callback_method

HTTP method Twilio should use when requesting the above URL. (🏢 not PII)

type

Type of Room, either peer-to-peer or group. Will be group by default. (🏢 not PII)

unique_name

A developer-supplied Name of the Room. This 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. (🏢 not PII)

url

The absolute URL for this resource. (🏢 not PII)

HTTP GET

Returns a single Room resource represented by {RoomNameOrSid} .

Retrieve an in-progress Room instance by UniqueName

You can retrieve an in-progress Room instance object using the Room's UniqueName. This makes it easier to interact with Twilio's REST API without having to keep track of Twilio's Room SID identifiers.

For example:

GET /Rooms/DailyStandup
Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('DailyStandup').fetch()
  .then((room) => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomUniqueName = "DailyStandup";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Fetch(roomUniqueName);

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms("DailyStandup")->fetch();

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.rooms('DailyStandup').fetch()

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('DailyStandup').fetch()

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .fetcher("DailyStandup")
                .fetch();

        System.out.println(room.getStatus());
    }

}
curl -G 'https://video.twilio.com/v1/Rooms/DailyStandup' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Retrieve an in-progress Room instance by UniqueName

Will return the Room instance object for the Room DailyStandup if the room is currently in-progress. If no Room exists by the name DailyStandup, or a Room by that name is only in completed status, the above request will return an HTTP 404 response.

Retrieve an in-progress or completed Room instance by RoomSid

A Room's Sid property is Twilio's own canonical unique identifier for a Room. You can always use the Room Sid to retrieve the Room, whether the room is in-progress or completed.

For example:

GET /Rooms/RMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
  .then((room) => {
    console.log(room.uniqueName);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomSid = "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Fetch(roomSid);

        Console.WriteLine(room.UniqueName);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")->fetch();

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .fetcher("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
                .fetch();

        System.out.println(room.getStatus());
    }

}
curl -G 'https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Retrieve an in-progress or completed Room instance by RoomSid

Will return the Room instance object for the Room with Sid RMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx, regardless of its status. If no Room exists with that Sid, the above request will return an HTTP 404 response.

HTTP POST

Modifies a Room resource.

Supported POST parameters

Name Description
Status

Required. Set to completed to end the Room. (🏢 not PII)

Complete a Room

Update a Room's status to completed with the following request to end the Room. All connected Participants will be immediately disconnected from the Room.

Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
  .update({
    status: 'completed'
  }).then((room) => {
    console.log(room.status);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomSid = "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Update(roomSid,
            RoomResource.RoomStatusEnum.Completed);

        Console.WriteLine(room.UniqueName);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video
    ->rooms("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
    ->update("completed");

echo $room->status;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video
  .rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
  .update(status: 'completed')

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
    .update('completed')

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .updater("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",	RoomStatus.COMPLETED)
                .update();

        System.out.println(room.getDateUpdated());
    }

}
curl -XPOST 'https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'Status=completed'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "completed",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": true,
    "unique_name": "unique_name",
    "max_participants": 10,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "duration": 10,
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Complete a Room

Rooms List Resource

Resource URI

/v1/Rooms

HTTP POST

Create a new Room with an HTTP POST to the Rooms list resource.

Supported POST parameters

Name Description
EnableTurn

Optional. Use Twilio Network Traversal for TURN service. Defaults to true. Only applicable to Rooms with type peer-to-peer. (🏢 not PII)

MaxParticipants

Optional. Maximum number of Participants in the Room. peer-to-peer rooms can have a maximum of 10 Participants. (🏢 not PII)

MediaRegion

Optional. Region for the media server in Group Rooms. Default region is us1. See the list of available Media Regions.This feature is not available in peer-to-peer rooms. (🏢 not PII)

RecordParticipantsOnConnect

Optional. Start Participant recording when connected. This feature is not available in peer-to-peer rooms. (🏢 not PII)

StatusCallback

Optional. A URL that Twilio sends asynchronous webhook requests to on every room event. If not provided, status callback events will not be dispatched. (🏢 not PII)

StatusCallbackMethod

Optional. HTTP method Twilio should use when requesting the above URL. Defaults to POST. (🏢 not PII)

Type

Optional. Type of room, either peer-to-peer or group. Will be group by default. (🏢 not PII)

UniqueName

Optional. Name of the Room. This is unique for in-progress rooms. If not provided, Room name will be set to the Room Sid. (🏢 not PII)

VideoCodecs

Optional. An array of video codecs supported when publishing a Track in the Room. VP8 and H264 codecs are supported. This feature is not available in peer-to-peer rooms (🏢 not PII)

Note: Rooms created via the REST API exist for five minutes to allow the first Participant to connect. If no Participants join within five minutes, the Room times out and a new Room must be created.

Example 1: Create a Room called "DailyStandup"

Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
const apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const apiKeySecret = 'your_api_key_secret';
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const Twilio = require('twilio');

const client = new Twilio(apiKeySid, apiKeySecret, { accountSid: accountSid });

client.video.rooms
  .create({
    uniqueName: 'DailyStandup',
  })
  .then(room => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(uniqueName: "DailyStandup");

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup'
]);

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.v1.rooms.create(unique_name: 'DailyStandup')

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms.create(unique_name='DailyStandup')

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator().setUniqueName("DailyStandup").create();

        System.out.println(room.getSid());
    }

}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Create a Room
Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.create({
  uniqueName: 'DailyStandup',
  type: 'peer-to-peer',
  enableTurn: 'false',
  statusCallback: 'http://example.org'
}).then((room) => {
  console.log(room.sid);
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(
            uniqueName: "DailyStandup",
            type: RoomResource.RoomTypeEnum.PeerToPeer,
            enableTurn: true,
            statusCallback: new Uri("http://example.org"));

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$p2pRoom = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup',
    'type' => 'peer-to-peer',
    'enableTurn' => false,
    'statusCallback' => 'http://example.org'
]);

echo $p2pRoom->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

p2p_room = client.video.rooms.create(
  unique_name: 'DailyStandup',
  type: 'peer-to-peer',
  enable_turn: false,
  status_callback: 'http://example.org')

puts p2p_room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

p2p_room = client.video.rooms.create( \
    unique_name='DailyStandup', \
    type='peer-to-peer', \
    enable_turn=True, \
    status_callback='http://example.org')

print(p2p_room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomType;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator()
                .setUniqueName("DailyStandup")
                .setType(RoomType.PEER_TO_PEER)
                .setEnableTurn(true)
                .setStatusCallback("http://example.org")
                .create();

        System.out.println(room.getSid());
    }
}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup' \
  -d 'Type=peer-to-peer' \
  -d 'EnableTurn=false' \
  -d 'StatusCallback=http://example.org'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": true,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "http://example.org",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Create a Peer-to-Peer Room
Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.create({
    uniqueName: 'DailyStandup',
    type: 'group',
    recordParticipantsOnConnect: 'true',
    statusCallback: 'http://example.org'
  }).then((room) => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(
            uniqueName: "DailyStandup",
            type: RoomResource.RoomTypeEnum.Group,
            recordParticipantsOnConnect: true,
            statusCallback: new Uri("http://example.org"));

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$groupRoom = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup',
    'type' => 'group',
    'recordParticipantsOnConnect' => true,
    'statusCallback' => 'http://example.org'
]);

echo $groupRoom->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

group_room = client.video.rooms.create(
  unique_name: 'DailyStandup',
  type: 'group',
  record_participants_on_connect: true,
  status_callback: 'http://example.org'
)

puts group_room
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

group_room = client.video.rooms.create( \
    unique_name='DailyStandup', \
    type='group', \
    record_participants_on_connect=True, \
    status_callback='http://example.org')

print(group_room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomType;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator()
                .setUniqueName("DailyStandup")
                .setType(RoomType.GROUP)
                .setRecordParticipantsOnConnect(true)
                .setStatusCallback("http://example.org")
                .create();

        System.out.println(room.getSid());
    }
}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup' \
  -d 'Type=group' \
  -d 'RecordParticipantsOnConnect=true' \
  -d 'StatusCallback=http://example.org'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "group",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "media_region": "us1",
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "http://example.org",
    "record_participants_on_connect": true,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
Create a Group Room

Once a Room is created, generate an Access Token containing the Room name and use one of Twilio's Video SDKs to connect to the Room.

For example, using the JavaScript SDK:

Twilio.Video.connect('$AccessTokenContainingRoomName').then(function(room) {
  console.log('Successfully joined a Room: ', room);
}, function(error) {
    console.error('Unable to connect to Room: ' +  error.message);
});

HTTP GET

Returns a list of Room resources created in the given account. The list includes paging information.

List Filters

The following GET query string parameters allow you to limit the list returned. Note, parameters are case-sensitive.

Name Description
DateCreatedAfter

Optional. Only show Rooms that started on or after this date, given as YYYY-MM-DD. (🏢 not PII)

DateCreatedBefore

Optional. Only show Rooms that started before this date, given as YYYY-MM-DD. (🏢 not PII)

Status

Optional. Only show Rooms with the given status. (🏢 not PII)

UniqueName

Optional. Only show Rooms with the provided Name. (🏢 not PII)

Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.list({
  uniqueName: 'DailyStandup'
}).then((room) => {
  recordings.forEach(recording => console.log(recording.sid));
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(uniqueName: "DailyStandup");

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$roomsByName = $client->video->rooms->read([
    'uniqueName' => 'DailyStandup'
]);

foreach ($roomsByName as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms = client.video.rooms.list(unique_name: 'DailyStandup')

rooms.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms_by_name = client.video.rooms.list(unique_name='DailyStandup')

for room in rooms_by_name:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.fetcher("DailyStandup").fetch();

        System.out.println(room.getSid());
    }
}
curl -G "https://video.twilio.com/v1/Rooms?UniqueName=DailyStandup" \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}
Retrieve a list of Rooms by UniqueName

Returns a list containing any Rooms with the name DailyStandup.

Filter Rooms by Status

Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.list({
  status: 'completed'
}).then((room) => {
  console.log(room.sid);
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(
            status: RoomResource.RoomStatusEnum.Completed);

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$roomsByStatus = $client->video->rooms->read([
    'status' => 'completed'
]);

foreach ($roomsByStatus as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms_by_status = client.video.rooms.list(status: 'completed')

rooms_by_status.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms_by_status = client.video.rooms.list(status='completed')

for room in rooms_by_status:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;
import com.twilio.base.ResourceSet;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        ResourceSet<Room> rooms = Room.reader().setStatus(RoomStatus.COMPLETED)
                .read();

        // Loop over rooms and print out a property for each one.
        for (Room room : rooms) {
            System.out.println(room.getSid());
        }
    }
}
curl -G 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'Status=completed'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}
Retrieve a list of Rooms by Status
Loading Code Samples...
Language
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
const apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const apiKeySecret = 'your_api_key_secret';
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const Twilio = require('twilio');

const client = new Twilio(apiKeySid, apiKeySecret, { accountSid: accountSid });

client.video.rooms
  .list({
    status: 'completed',
    uniqueName: 'DailyStandup',
  })
  .then(room => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(
            status: RoomResource.RoomStatusEnum.Completed,
            uniqueName: "DailyStandup");

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$rooms = $client->video->rooms->read([
    'status' => 'completed',
    'uniqueName' => 'DailyStandup'
]);

foreach ($rooms as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms = client.video.v1.rooms.list(
  status: 'completed',
  unique_name: 'DailyStandup'
)

rooms.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms = client.video.rooms.list(status='completed', unique_name='DailyStandup')

for room in rooms:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.base.ResourceSet;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        ResourceSet<Room> rooms = Room.reader().setStatus(RoomStatus.COMPLETED)
                .setUniqueName("DailyStandup").read();

        // Loop over rooms and print out a property for each one.
        for (Room room : rooms) {
            System.out.println(room.getSid());
        }
    }
}
curl -G 'https://video.twilio.com/v1/Rooms' \
   -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
   -d 'Status=completed' \
   -d 'UniqueName=DailyStandup'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}
Retrieve a list of completed Rooms

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.

Loading Code Samples...
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('DailyStandup').fetch()
  .then((room) => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomUniqueName = "DailyStandup";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Fetch(roomUniqueName);

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms("DailyStandup")->fetch();

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.rooms('DailyStandup').fetch()

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('DailyStandup').fetch()

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .fetcher("DailyStandup")
                .fetch();

        System.out.println(room.getStatus());
    }

}
curl -G 'https://video.twilio.com/v1/Rooms/DailyStandup' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
  .then((room) => {
    console.log(room.uniqueName);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomSid = "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Fetch(roomSid);

        Console.WriteLine(room.UniqueName);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")->fetch();

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .fetcher("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
                .fetch();

        System.out.println(room.getStatus());
    }

}
curl -G 'https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
  .update({
    status: 'completed'
  }).then((room) => {
    console.log(room.status);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";
        const string roomSid = "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Update(roomSid,
            RoomResource.RoomStatusEnum.Completed);

        Console.WriteLine(room.UniqueName);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video
    ->rooms("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
    ->update("completed");

echo $room->status;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video
  .rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')
  .update(status: 'completed')

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms('RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
    .update('completed')

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room
                .updater("RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",	RoomStatus.COMPLETED)
                .update();

        System.out.println(room.getDateUpdated());
    }

}
curl -XPOST 'https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'Status=completed'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "completed",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": true,
    "unique_name": "unique_name",
    "max_participants": 10,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "duration": 10,
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
const apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const apiKeySecret = 'your_api_key_secret';
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const Twilio = require('twilio');

const client = new Twilio(apiKeySid, apiKeySecret, { accountSid: accountSid });

client.video.rooms
  .create({
    uniqueName: 'DailyStandup',
  })
  .then(room => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(uniqueName: "DailyStandup");

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$room = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup'
]);

echo $room->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

room = client.video.v1.rooms.create(unique_name: 'DailyStandup')

puts room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

room = client.video.rooms.create(unique_name='DailyStandup')

print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator().setUniqueName("DailyStandup").create();

        System.out.println(room.getSid());
    }

}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.create({
  uniqueName: 'DailyStandup',
  type: 'peer-to-peer',
  enableTurn: 'false',
  statusCallback: 'http://example.org'
}).then((room) => {
  console.log(room.sid);
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(
            uniqueName: "DailyStandup",
            type: RoomResource.RoomTypeEnum.PeerToPeer,
            enableTurn: true,
            statusCallback: new Uri("http://example.org"));

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$p2pRoom = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup',
    'type' => 'peer-to-peer',
    'enableTurn' => false,
    'statusCallback' => 'http://example.org'
]);

echo $p2pRoom->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

p2p_room = client.video.rooms.create(
  unique_name: 'DailyStandup',
  type: 'peer-to-peer',
  enable_turn: false,
  status_callback: 'http://example.org')

puts p2p_room.sid
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

p2p_room = client.video.rooms.create( \
    unique_name='DailyStandup', \
    type='peer-to-peer', \
    enable_turn=True, \
    status_callback='http://example.org')

print(p2p_room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomType;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator()
                .setUniqueName("DailyStandup")
                .setType(RoomType.PEER_TO_PEER)
                .setEnableTurn(true)
                .setStatusCallback("http://example.org")
                .create();

        System.out.println(room.getSid());
    }
}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup' \
  -d 'Type=peer-to-peer' \
  -d 'EnableTurn=false' \
  -d 'StatusCallback=http://example.org'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "peer-to-peer",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": true,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "http://example.org",
    "record_participants_on_connect": false,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.create({
    uniqueName: 'DailyStandup',
    type: 'group',
    recordParticipantsOnConnect: 'true',
    statusCallback: 'http://example.org'
  }).then((room) => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var room = RoomResource.Create(
            uniqueName: "DailyStandup",
            type: RoomResource.RoomTypeEnum.Group,
            recordParticipantsOnConnect: true,
            statusCallback: new Uri("http://example.org"));

        Console.WriteLine(room.Sid);
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$groupRoom = $client->video->rooms->create([
    'uniqueName' => 'DailyStandup',
    'type' => 'group',
    'recordParticipantsOnConnect' => true,
    'statusCallback' => 'http://example.org'
]);

echo $groupRoom->sid;
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

group_room = client.video.rooms.create(
  unique_name: 'DailyStandup',
  type: 'group',
  record_participants_on_connect: true,
  status_callback: 'http://example.org'
)

puts group_room
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

group_room = client.video.rooms.create( \
    unique_name='DailyStandup', \
    type='group', \
    record_participants_on_connect=True, \
    status_callback='http://example.org')

print(group_room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomType;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.creator()
                .setUniqueName("DailyStandup")
                .setType(RoomType.GROUP)
                .setRecordParticipantsOnConnect(true)
                .setStatusCallback("http://example.org")
                .create();

        System.out.println(room.getSid());
    }
}
curl -XPOST 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'UniqueName=DailyStandup' \
  -d 'Type=group' \
  -d 'RecordParticipantsOnConnect=true' \
  -d 'StatusCallback=http://example.org'
{
    "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "date_created": "2015-07-30T20:00:00Z",
    "date_updated": "2015-07-30T20:00:00Z",
    "status": "in-progress",
    "type": "group",
    "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "enable_turn": false,
    "unique_name": "DailyStandup",
    "max_participants": 10,
    "media_region": "us1",
    "duration": 0,
    "status_callback_method": "POST",
    "status_callback": "http://example.org",
    "record_participants_on_connect": true,
    "end_time": "2015-07-30T20:00:00Z",
    "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
    "links": {
        "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.list({
  uniqueName: 'DailyStandup'
}).then((room) => {
  recordings.forEach(recording => console.log(recording.sid));
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(uniqueName: "DailyStandup");

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$roomsByName = $client->video->rooms->read([
    'uniqueName' => 'DailyStandup'
]);

foreach ($roomsByName as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms = client.video.rooms.list(unique_name: 'DailyStandup')

rooms.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms_by_name = client.video.rooms.list(unique_name='DailyStandup')

for room in rooms_by_name:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        Room room = Room.fetcher("DailyStandup").fetch();

        System.out.println(room.getSid());
    }
}
curl -G "https://video.twilio.com/v1/Rooms?UniqueName=DailyStandup" \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
var apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var apiKeySecret = 'your_api_key_secret';
var accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
var Twilio = require('twilio');

var client = new Twilio(apiKeySid, apiKeySecret, {accountSid: accountSid});

client.video.rooms.list({
  status: 'completed'
}).then((room) => {
  console.log(room.sid);
});
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(
            status: RoomResource.RoomStatusEnum.Completed);

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$roomsByStatus = $client->video->rooms->read([
    'status' => 'completed'
]);

foreach ($roomsByStatus as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms_by_status = client.video.rooms.list(status: 'completed')

rooms_by_status.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms_by_status = client.video.rooms.list(status='completed')

for room in rooms_by_status:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;
import com.twilio.base.ResourceSet;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        ResourceSet<Room> rooms = Room.reader().setStatus(RoomStatus.COMPLETED)
                .read();

        // Loop over rooms and print out a property for each one.
        for (Room room : rooms) {
            System.out.println(room.getSid());
        }
    }
}
curl -G 'https://video.twilio.com/v1/Rooms' \
  -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
  -d 'Status=completed'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}
SDK Version:
  • 5.x
Response Format:
  • json
SDK Version:
  • 7.x
SDK Version:
  • 3.x
SDK Version:
  • 5.x
SDK Version:
  • 6.x
SDK Version:
  • 5.x
Format:
  • JSON
// NOTE: This example uses the next generation Twilio helper library - for more
// information on how to download and install this version, visit
// https://www.twilio.com/docs/libraries/node
const apiKeySid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const apiKeySecret = 'your_api_key_secret';
const accountSid = 'ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX';
const Twilio = require('twilio');

const client = new Twilio(apiKeySid, apiKeySecret, { accountSid: accountSid });

client.video.rooms
  .list({
    status: 'completed',
    uniqueName: 'DailyStandup',
  })
  .then(room => {
    console.log(room.sid);
  });
// Download the twilio-csharp library from twilio.com/docs/libraries/csharp
using System;
using Twilio;
using Twilio.Rest.Video.V1;

class Example
{
    static void Main (string[] args)
    {
        // Find your Account SID and Auth Token at twilio.com/console
        const string apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
        const string apiKeySecret = "your_api_key_secret";

        TwilioClient.Init(apiKeySid, apiKeySecret);

        var rooms = RoomResource.Read(
            status: RoomResource.RoomStatusEnum.Completed,
            uniqueName: "DailyStandup");

        foreach (var room in rooms)
        {
            Console.WriteLine(room.Sid);
        }
    }
}
<?php
// Get the PHP helper library from twilio.com/docs/php/install
require_once '/path/to/vendor/autoload.php'; // Loads the library
use Twilio\Rest\Client;

// Your Account Sid and Auth Token from twilio.com/console
$apiKeySid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$apiKeySecret = "your_auth_apiKeySecret";
$client = new Client($apiKeySid, $apiKeySecret);

$rooms = $client->video->rooms->read([
    'status' => 'completed',
    'uniqueName' => 'DailyStandup'
]);

foreach ($rooms as $room) {
    echo $room->sid;
}
# Download the Ruby helper library from twilio.com/docs/libraries/ruby
require 'twilio-ruby'

# Get your Account Sid and Auth Token from https://www.twilio.com/console
api_key_sid = 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
api_key_secret = 'your_api_key_secret'

client = Twilio::REST::Client.new api_key_sid, api_key_secret

rooms = client.video.v1.rooms.list(
  status: 'completed',
  unique_name: 'DailyStandup'
)

rooms.each do |room|
  puts room.sid
end
# Download the Python helper library from twilio.com/docs/python/install
from twilio.rest import Client

# Your Account Sid and Auth Token from twilio.com/console
api_key_sid = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
api_key_secret = "your_api_key_secret"
client = Client(api_key_sid, api_key_secret)

rooms = client.video.rooms.list(status='completed', unique_name='DailyStandup')

for room in rooms:
    print(room.sid)
import com.twilio.Twilio;
import com.twilio.base.ResourceSet;
import com.twilio.rest.video.v1.Room;
import com.twilio.rest.video.v1.Room.RoomStatus;

public class Example {
    // Find your Account Sid and Token at twilio.com/console
    public static final String API_KEY_SID = "SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
    public static final String API_KEY_SECRET = "your_api_key_secret";

    public static void main(String args[]) {
        // Initialize the client
        Twilio.init(API_KEY_SID, API_KEY_SECRET);

        ResourceSet<Room> rooms = Room.reader().setStatus(RoomStatus.COMPLETED)
                .setUniqueName("DailyStandup").read();

        // Loop over rooms and print out a property for each one.
        for (Room room : rooms) {
            System.out.println(room.getSid());
        }
    }
}
curl -G 'https://video.twilio.com/v1/Rooms' \
   -u 'SKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX:your_api_key_secret' \
   -d 'Status=completed' \
   -d 'UniqueName=DailyStandup'
{
    "rooms": [{
        "api_key_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "date_created": "2015-07-30T20:00:00Z",
        "date_updated": "2015-07-30T20:00:00Z",
        "status": "in-progress",
        "type": "peer-to-peer",
        "sid": "RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "enable_turn": false,
        "unique_name": "DailyStandup",
        "max_participants": 10,
        "duration": 0,
        "status_callback_method": "POST",
        "status_callback": "",
        "record_participants_on_connect": false,
        "end_time": "2015-07-30T20:00:00Z",
        "url": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
        "links": {
            "recordings": "https://video.twilio.com/v1/Rooms/RMXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Recordings"
        }
    }],
    "meta": {
        "page": 0,
        "count": 1,
        "page_size": 50,
        "first_page_url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "previous_page_url": null,
        "url": "https://video.twilio.com/v1/Rooms?PageSize=50&Page=0",
        "next_page_url": null,
        "key": "rooms"
    }
}