Sample - Twilio API
GET/2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json

Retrieve a conference

Retrieves one conference resource from an account. Provide the conference's Sid together with the owning AccountSid to return its status, region, lifecycle timestamps, and related resource information.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
AccountSidstringrequired
The account SID that owns the conference. Must be a 34-character value matching the `AC` SID format.
Sidstringrequired
The unique conference SID to retrieve. Must be a 34-character value matching the `CF` SID format.

1 status code
200Returns the conference object, including its account SID, timestamps, friendly name, region, lifecycle status, related resource URIs, ending reason, and ending call SID.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Conference resource.
date_createdstringoptional
The date and time in UTC that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
The date and time in UTC that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
api_versionstringoptional
The API version used to create this conference.
friendly_namestringoptional
A string that you assigned to describe this conference room. Maximum length is 128 characters.
regionstringoptional
A string that represents the Twilio Region where the conference audio was mixed. May be `us1`, `us2`, `ie1`, `de1`, `sg1`, `br1`, `au1`, and `jp1`. Basic conference audio will always be mixed in `us1`. Global Conference audio will be mixed nearest to the majority of participants.
sidstringoptional
The unique, Twilio-provided string used to identify this Conference resource.
statusstringoptional
The status of this conference. Can be: `init`, `in-progress`, or `completed`.
Allowed:initin-progresscompleted
uristringoptional
The URI of this resource, relative to `https://api.twilio.com`.
subresource_urisobjectoptional
A list of related resources identified by their URIs relative to `https://api.twilio.com`.
reason_conference_endedstringoptional
The reason why a conference ended. When a conference is in progress, will be `null`. When conference is completed, can be: `conference-ended-via-api`, `participant-with-end-conference-on-exit-left`, `participant-with-end-conference-on-exit-kicked`, `last-participant-kicked`, or `last-participant-left`.
Allowed:conference-ended-via-apiparticipant-with-end-conference-on-exit-leftparticipant-with-end-conference-on-exit-kickedlast-participant-kickedlast-participant-left
call_sid_ending_conferencestringoptional
The call SID that caused the conference to end.

Error handling

AccountSid must be a 34-character account SID beginning with AC, and Sid must be a 34-character conference SID beginning with CF. The conference identifier must refer to a conference owned by the specified account.