Path parameters

• AccountSid string Required

  The SID of the Account that created the Call resource(s) to read.

Query parameters

• To string(phone-number)

  Only show calls made to this phone number, SIP address, Client identifier or SIM SID.

• From string(phone-number)

  Only include calls from this phone number, SIP address, Client identifier or SIM SID.

• ParentCallSid string

  Only include calls spawned by calls with this SID.

• Status string

  The status of the calls to include. Can be: queued, ringing, in-progress, canceled, completed, failed, busy, or no-answer.

  Values are queued, ringing, in-progress, completed, busy, failed, no-answer, or canceled.

• StartTime string(date-time)

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

• StartTime< string(date-time)

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

• StartTime> string(date-time)

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

• EndTime string(date-time)

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

• EndTime< string(date-time)

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

• EndTime> string(date-time)

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

• PageSize integer

  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.

Responses

• 200

  OK

  Hide response attributes Show response attributes object

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

    • account_sid string | null

      The SID of the Account that created this resource

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

    • answered_by string | null

      Either human or machine if this call was initiated with answering machine detection. Empty otherwise.

    • api_version string | null

      The API Version used to create the call

    • caller_name string | null

      The caller's name if this call was an incoming call to a phone number with caller ID Lookup enabled. Otherwise, empty.

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

      The RFC 2822 date and time in GMT that this resource was created

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

      The RFC 2822 date and time in GMT that this resource was last updated

    • direction string | null

      A string describing the direction of the call. inbound for inbound calls, outbound-api for calls initiated via the REST API or outbound-dial for calls initiated by a Dial verb.

    • duration string | null

      The length of the call in seconds.

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

      The end time of the call. Null if the call did not complete successfully.

    • forwarded_from string | null

      The forwarding phone number if this call was an incoming call forwarded from another number (depends on carrier supporting forwarding). Otherwise, empty.

    • from string | null

      The phone number, SIP address or Client identifier that made this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name.

    • from_formatted string | null

      The calling phone number, SIP address, or Client identifier formatted for display.

    • group_sid string | null

      The Group SID associated with this call. If no Group is associated with the call, the field is empty.

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

    • parent_call_sid string | null

      The SID that identifies the call that created this leg.

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

    • phone_number_sid string | null

      If the call was inbound, this is the SID of the IncomingPhoneNumber resource that received the call. If the call was outbound, it is the SID of the OutgoingCallerId resource from which the call was placed.

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

    • price string | null

      The charge for this call, in the currency associated with the account. Populated after the call is completed. May not be immediately available.

    • price_unit string(currency) | null

      The currency in which Price is measured.

    • queue_time string | null

      The wait time in milliseconds before the call is placed.

    • sid string | null

      The unique string that identifies this resource

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

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

      The start time of the call. Null if the call has not yet been dialed.

    • status string | null

      The status of this call.

      Values are queued, ringing, in-progress, completed, busy, failed, no-answer, or canceled.

    • subresource_uris object(uri-map) | null

      A list of related subresources identified by their relative URIs

    • to string | null

      The phone number, SIP address or Client identifier that received this call. Phone numbers are in E.164 format (e.g., +16175551212). SIP addresses are formatted as name@company.com. Client identifiers are formatted client:name.

    • to_formatted string | null

      The phone number, SIP address or Client identifier that received this call. Formatted for display.

    • trunk_sid string | null

      The (optional) unique identifier of the trunk resource that was used for this call.

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

    • uri string(uri) | null

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

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