Conference Recordings

List Conference Recordings

Lists the saved voice recordings associated with one conference. Use the account-level Recordings collection to browse media across calls and conferences, or Video Room Recordings for video-room media.

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/{ConferenceSid}/Recordings

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that created this conference.

ConferenceSidstring uuid required

Universal Unique Identifier.

The unique identifier for the conference this participant is in.

Query parameters

DateCreatedstring

Shows recordings that were created on the date provided. Format: YYYY-MM-DD.

DateCreated<string

Shows recordings that were created before the date provided. Format: YYYY-MM-DD.

DateCreated>string

Shows recordings that were created after the date provided. Format: YYYY-MM-DD.

Pageinteger

The page number to retrieve. Page numbers are zero-indexed, so the first page is 0.

PageSizeinteger

The number of results to return per page. The default is 50, and the maximum is 1000.

PageTokenstring

A token used to retrieve a specific page of results. Must start with PA or PB.

Response

The request has succeeded.

uristring required

The URI of the current page.

first_page_uristring required

The URI of the first page.

next_page_uristring nullable required

The URI of the next page.

previous_page_uristring nullable required

The URI of the previous page.

pageinteger required

The current page number.

page_sizeinteger required

The number of items per page.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings?PageToken=PA1234",
  "first_page_uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings",
  "next_page_uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings?Page=1&PageToken=PA5678",
  "page_size": 50,
  "recordings": [
    {
      "api_version": "2010-04-01",
      "channel": "1",
      "channels": "1",
      "date_created": "Tue, 25 Sep 2018 23:00:00 +0000",
      "date_updated": "Wed, 26 Sep 2018 23:00:04 +0000",
      "start_time": "Tue, 25 Sep 2018 23:00:00 +0000",
      "end_time": "Wed, 26 Sep 2018 23:00:04 +0000",
      "duration": 4,
      "price": "-0.0025",
      "price_unit": "USD",
      "uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Conferences/43bb71ee-553f-4074-bb20-8e2747647cce/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142.json",
      "subresource_uris": {
        "transcriptions": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings/19e436af-5688-4307-b03b-bdb2b42b8142/Transcriptions.json"
      },
      "trim": "do-not-trim"
    }
  ]
}

Changes

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

  • 2916d5e3072e34See the full diff
    • the // response's property type changed from string to no type, and format from uuid to no format for status

      response-property-type-changed

    • the // response's property format changed from uuid to no format for status

      response-property-type-changed

    • the // response's property type changed from string to no type, and format from uuid to no format for status

      response-property-type-changed

    • added to the // response property allOf list for the response status

      response-property-all-of-added

    • added to the // response property allOf list for the response status

      response-property-all-of-added

    • added to the // response property anyOf list for the response status

      response-property-any-of-added

    • removed subschema #1 from the // response property anyOf list for the response status

      response-property-any-of-removed

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the / response property for the status

      response-property-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the ////// response property for the status

      response-property-unevaluated-properties-added

    • response property next_page_uri list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property previous_page_uri list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/call_sid list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/conference_sid list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/encryption_details list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/end_time list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/error_code list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/price list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • response property recordings/items/start_time list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

    • endpoint added

      endpoint-added

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog