Path parameters

• AccountSid string Required

  The SID of the Account that created the Recording resources to read.

  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

Query parameters

• DateCreated string(date-time)

  Only include recordings that were created on this date. Specify a date as YYYY-MM-DD in GMT, for example: 2009-07-06, to read recordings that were created on this date. You can also specify an inequality, such as DateCreated<=YYYY-MM-DD, to read recordings that were created on or before midnight of this date, and DateCreated>=YYYY-MM-DD to read recordings that were created on or after midnight of this date.

• DateCreated< string(date-time)

  Only include recordings that were created on this date. Specify a date as YYYY-MM-DD in GMT, for example: 2009-07-06, to read recordings that were created on this date. You can also specify an inequality, such as DateCreated<=YYYY-MM-DD, to read recordings that were created on or before midnight of this date, and DateCreated>=YYYY-MM-DD to read recordings that were created on or after midnight of this date.

• DateCreated> string(date-time)

  Only include recordings that were created on this date. Specify a date as YYYY-MM-DD in GMT, for example: 2009-07-06, to read recordings that were created on this date. You can also specify an inequality, such as DateCreated<=YYYY-MM-DD, to read recordings that were created on or before midnight of this date, and DateCreated>=YYYY-MM-DD to read recordings that were created on or after midnight of this date.

• CallSid string

  The Call SID of the resources to read.

  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.

• ConferenceSid string

  The Conference SID that identifies the conference associated with the recording to read.

  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CF[0-9a-fA-F]{32}$.

• IncludeSoftDeleted boolean

  A boolean parameter indicating whether to retrieve soft deleted recordings or not. Recordings metadata are kept after deletion for a retention period of 40 days.

• PageSize integer(int64)

  How many resources to return in each list page. The default is 50, and the maximum is 1000.

  Minimum value is 1, maximum value is 1000.

• Page integer

  The page index. This value is simply for client state.

  Minimum value is 0.

• PageToken string

  The page token. This is provided by the API.

Responses

• 200 application/json

  OK

  Hide headers attributes Show headers attributes

  • Access-Control-Allow-Origin string

    Specify the origin(s) allowed to access the resource

  • Access-Control-Allow-Methods string

    Specify the HTTP methods allowed when accessing the resource

  • Access-Control-Allow-Headers string

    Specify the headers allowed when accessing the resource

  • Access-Control-Allow-Credentials boolean

    Indicates whether the browser should include credentials

  • Access-Control-Expose-Headers string

    Headers exposed to the client

  Hide response attributes Show response attributes object

  • recordings array[object]
    Hide recordings attributes Show recordings attributes object

    • account_sid string | null

      The SID of the Account that created the Recording resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • api_version string | null

      The API version used during the recording.

    • call_sid string | null

      The SID of the Call the Recording resource is associated with. This will always refer to the parent leg of a two-leg call.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CA[0-9a-fA-F]{32}$.

    • conference_sid string | null

      The Conference SID that identifies the conference associated with the recording, if a conference recording.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^CF[0-9a-fA-F]{32}$.

    • date_created string(date-time-rfc-2822) | null

      The date and time in GMT that the resource was created specified in RFC 2822 format.

    • date_updated string(date-time-rfc-2822) | null

      The date and time in GMT that the resource was last updated specified in RFC 2822 format.

    • start_time string(date-time-rfc-2822) | null

      The start time of the recording in GMT and in RFC 2822 format.

    • duration string | null

      The length of the recording in seconds.

    • sid string | null

      The unique string that that we created to identify the Recording resource.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^RE[0-9a-fA-F]{32}$.

    • price string | null

      The one-time cost of creating the recording in the price_unit currency.

    • price_unit string | null

      The currency used in the price property. Example: USD.

    • status string

      The status of the recording. Can be: processing, completed, absent or deleted. For information about more detailed statuses on in-progress recordings, check out how to Update a Recording Resource.

      Values are in-progress, paused, stopped, processing, completed, absent, or deleted.

    • channels integer | null

      The number of channels in the final recording file. Can be: 1 or 2. Default: 1.

    • source string

      How the recording was created. Can be: DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, and StartConferenceRecordingAPI.

      Values are DialVerb, Conference, OutboundAPI, Trunking, RecordVerb, StartCallRecordingAPI, or StartConferenceRecordingAPI.

    • error_code integer | null

      The error code that describes why the recording is absent. The error code is described in our Error Dictionary. This value is null if the recording status is not absent.

    • uri string | null

      The URI of the resource, relative to https://api.twilio.com.

    • encryption_details

      How to decrypt the recording if it was encrypted using Call Recording Encryption feature.

    • subresource_uris object(uri-map) | null

      A list of related resources identified by their relative URIs.

    • media_url string(uri) | null

      The URL of the media file associated with this recording resource. When stored externally, this is the full URL location of the media file.

  • end integer
  • first_page_uri string(uri)
  • next_page_uri string(uri) | null
  • page integer
  • page_size integer
  • previous_page_uri string(uri) | null
  • start integer
  • uri string(uri)