Fetch the call specified by the provided Call SID

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

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

Fetch the call specified by the provided Call SID

Path parameters

  • AccountSid string Required

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

  • Sid string Required

    The SID of the Call resource to fetch.

Responses

  • OK

    Hide response attributes Show response attributes 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

GET /2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json
curl \
 -X GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Calls/{Sid}.json \
 --user "username:password"
Response examples (200)
{
  "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"
}
Response examples (200)
{
  "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"
}