Recordings

List all Recordings

Changed on

Lists saved voice recordings across the account's calls and conferences. Each recording has a SID used to retrieve or delete its media. SignalWire REST Recordings provide JSON operations, while Video Room Recordings contain video-room media. Results are ordered by creation date, newest first.

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

Request

  • Base URL
    https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01
  • URL
    https://YOUR_SPACE.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Recordings
  • Auth
    HTTP basic

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that is associated with this recording.

Query parameters

DateCreatedstring

Filter by recordings created on this exact date (RFC 2822 format).

DateCreated<string

Filter by recordings created before this date (RFC 2822 format).

DateCreated>string

Filter by recordings created after this date (RFC 2822 format).

CallSidstring uuid

Universal Unique Identifier.

Filter by recordings associated with a specific call.

ConferenceSidstring uuid

Universal Unique Identifier.

Filter by recordings associated with a specific conference.

Pageinteger

The page number to retrieve (zero-indexed).

PageSizeinteger

The number of results per page. Default is 50, maximum is 1000.

PageTokenstring

Token for cursor-based pagination. Required when navigating to pages beyond the first.

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. Null if there are no more pages.

previous_page_uristring nullable required

The URI of the previous page. Null if this is the first page.

pageinteger required

The current page number (zero-indexed).

page_sizeinteger required

The number of items per page.

Example response

{
  "uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings?Page=0&PageSize=50",
  "first_page_uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings",
  "next_page_uri": "/api/laml/2010-04-01/Accounts/720796a0-8ee9-4350-83bd-2d07a3121f1e/Recordings?Page=1&PageSize=50&PageToken=PA19e436af-5688-4307-b03b-bdb2b42b8142",
  "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/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

  • 2916d5e3072eRevision changes
    • breaking

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

    • breaking

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

    • breaking

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

    • breaking

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

  • 5344c0c93a4cRevision changes
    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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