Conferences

Retrieve a Conference

Retrieves one voice conference by SID so you can inspect a known conference and its current activity. Use List All Conferences to discover SIDs; Video Conferences are separate hosted video resources.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

get/Accounts/{AccountSid}/Conferences/{Sid}

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that created this conference.

Sidstring uuid required

Universal Unique Identifier.

The unique identifier for this conference.

Response

The request has succeeded.

sidstring uuid required

Universal Unique Identifier.

account_sidstring uuid required

Universal Unique Identifier.

date_createdstring required

The date, in RFC 2822 format, this conference was created.

date_updatedstring required

The date, in RFC 2822 format, this conference was updated.

friendly_namestring required

A description, up to 64 characters, of the conference room.

status'init' | 'in-progress' | 'completed' required

Conference status.

api_versionstring required

The version of the SignalWire API.

regionstring required

The region where this conference audio was mixed.

uristring required

The URI for this conference.

Example response

{
  "date_created": "Mon, 24 Sept 2018 21:00:00 +0000",
  "date_updated": "Tue, 25 Sept 2018 20:00:00 +0000",
  "friendly_name": "My Conference Room",
  "api_version": "2010-04-01",
  "region": "us1",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf.json",
  "subresource_uris": {
    "participants": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants.json",
    "recordings": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Recordings.json"
  }
}

Changes

Changed in 4 of the 40 revisions of this API.8234

May 12, 20262916d5e3072e22See the full diff
- ▲
  the account_sid response's property type/format changed from string/uuid to / for status 200
  response-property-type-changed
- ▲
  the sid response's property type/format changed from string/uuid to / for status 200
  response-property-type-changed
- ○
  added uuid to the account_sid response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added uuid to the sid response property allOf list for the response status 200
  response-property-all-of-added
May 12, 20265344c0c93a4c5See the full diff
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 200
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 400
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 401
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the response body for the status 404
  response-body-unevaluated-properties-added
- ○
  added 'unevaluatedProperties' constraint to the subresource_uris/allOf[ConferenceSubresourceUris]/ response property for the status 200
  response-property-unevaluated-properties-added
Jan 19, 2026d5fbaaddfa3e114See the full diff
- ▲
  the region response's property type/format changed from / to string/ for status 200
  response-property-type-changed
- ○
  added the non-success response with the status 400
  response-non-success-status-added
- ○
  removed ConferenceRegion from the region response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  the response property account_sid became required for the status 200
  response-property-became-required
- ○
  the response property api_version became required for the status 200
  response-property-became-required
- ○
  the response property date_created became required for the status 200
  response-property-became-required
- ○
  the response property date_updated became required for the status 200
  response-property-became-required
- ○
  the response property friendly_name became required for the status 200
  response-property-became-required
- ○
  the response property region became required for the status 200
  response-property-became-required
- ○
  the response property sid became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required
- ○
  the response property subresource_uris became required for the status 200
  response-property-became-required
- ○
  the response property subresource_uris/allOf[ConferenceSubresourceUris]/participants became required for the status 200
  response-property-became-required
- ○
  the response property subresource_uris/allOf[ConferenceSubresourceUris]/recordings became required for the status 200
  response-property-became-required
- ○
  the response property uri became required for the status 200
  response-property-became-required
This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 15, 20263c88f14db21e5213See the full diff
- ▲
  added the new path request parameter AccountSid
  new-request-path-parameter
- ▲
  added the new path request parameter Sid
  new-request-path-parameter
- ▲
  the region response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the status response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the subresource_uris response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property subresource_uris/participants from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property subresource_uris/recordings from the response with the 200 status
  response-optional-property-removed
- ○
  added the non-success response with the status 401
  response-non-success-status-added
- ○
  added the non-success response with the status 404
  response-non-success-status-added
- ○
  added ConferenceRegion to the region response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added ConferenceStatus to the status response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added ConferenceSubresourceUris to the subresource_uris response property allOf list for the response status 200
  response-property-all-of-added
- ○
  removed the au1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the br1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the de1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the ie1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the jp1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the sg1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the us1 enum value from the region response property for the response status 200
  response-property-enum-value-removed
- ○
  removed the us2 enum value from the region response property for the response status 200
  response-property-enum-value-removed
This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history