Retrieves a collection of calls made to and from your account

GET /2010-04-01/Accounts/{AccountSid}/Calls.json

A Call is an object that represents a connection between a telephone and Twilio.

Retrieves a collection of calls made to and from your account

Path parameters

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
      • 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 [email protected]. 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 [email protected]. 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)
GET /2010-04-01/Accounts/{AccountSid}/Calls.json 
curl \
 -X GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls.json \
 --user "username:password"
Response examples (200) 
{
  "calls": [
    {
      "account_sid": "string",
      "answered_by": "string",
      "api_version": "string",
      "caller_name": "string",
      "date_created": "string",
      "date_updated": "string",
      "direction": "string",
      "duration": "string",
      "end_time": "string",
      "forwarded_from": "string",
      "from": "string",
      "from_formatted": "string",
      "group_sid": "string",
      "parent_call_sid": "string",
      "phone_number_sid": "string",
      "price": "string",
      "price_unit": "string",
      "queue_time": "string",
      "sid": "string",
      "start_time": "string",
      "status": "queued",
      "subresource_uris": {},
      "to": "string",
      "to_formatted": "string",
      "trunk_sid": "string",
      "uri": "https://example.com"
    }
  ],
  "end": 42,
  "first_page_uri": "https://example.com",
  "next_page_uri": "https://example.com",
  "page": 42,
  "page_size": 42,
  "previous_page_uri": "https://example.com",
  "start": 42,
  "uri": "https://example.com"
}