Fetch a call

GET 
/texml/Accounts/:account_sid/Calls/:call_sid

Returns an individual call identified by its CallSid. This endpoint is eventually consistent.

Path Parameters

call_sid stringrequired

The CallSid that identifies the call to update.

account_sid stringrequired

The id of the account the resource belongs to.

200: Call resource.

application/json

• Schema
• Example (from schema)

Schema

account_sid string

The id of the account the resource belongs to.

answered_by string

Possible values: [human, machine, not_sure]

The value of the answering machine detection result, if this feature was enabled for the call.

caller_name string

Caller ID, if present.

date_created string

The timestamp of when the resource was created.

date_updated string

The timestamp of when the resource was last updated.

direction string

Possible values: [inbound, outbound]

The direction of this call.

duration string

The duration of this call, given in seconds.

end_time string

The end time of this call.

from string

The phone number or SIP address that made this call.

from_formatted string

The from number formatted for display.

price string

The price of this call, the currency is specified in the price_unit field. Only populated when the call cost feature is enabled for the account.

price_unit string

The unit in which the price is given.

sid string

The identifier of this call.

start_time string

The start time of this call.

status string

Possible values: [ringing, in-progress, canceled, completed, failed, busy, no-answer]

The status of this call.

to string

The phone number or SIP address that received this call.

to_formatted string

The to number formatted for display.

uri string

The relative URI for this call.

{
  "account_sid": "61bf923e-5e4d-4595-a110-56190ea18a1b",
  "answered_by": null,
  "caller_name": "+13122010094",
  "date_created": "Thu, 15 Jun 2023 09:56:45 +0000",
  "date_updated": "Thu, 15 Jun 2023 09:56:56 +0000",
  "direction": "inbound",
  "duration": "11",
  "end_time": "Thu, 15 Jun 2023 09:56:56 +0000",
  "from": "+13123456789",
  "from_formatted": "(312) 345-6789",
  "price": null,
  "price_unit": null,
  "sid": "v3:KBnLO0ZK3DhKM5s7bE9VluaSmKsOchKht_fUYvxcp8ysbmzCCtpkmA",
  "start_time": "Thu, 15 Jun 2023 09:56:45 +0000",
  "status": "completed",
  "to": "+13987654321",
  "to_formatted": "(398) 765-4321",
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls/v3:KBnLO0ZK3DhKM5s7bE9VluaSmKsOchKht_fUYvxcp8ysbmzCCtpkmA.json"
}

404: Resource not found

application/json

• Schema
• Example (from schema)

Schema

errors

object[]

Array [

detail string

]

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}

Request samples

• cURL

---

curl -L 'https://api.telnyx.com/v2/texml/Accounts/:account_sid/Calls/:call_sid' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'

Response samples

• 200
• 404

---

{
  "account_sid": "61bf923e-5e4d-4595-a110-56190ea18a1b",
  "answered_by": null,
  "caller_name": "+13122010094",
  "date_created": "Thu, 15 Jun 2023 09:56:45 +0000",
  "date_updated": "Thu, 15 Jun 2023 09:56:56 +0000",
  "direction": "inbound",
  "duration": "11",
  "end_time": "Thu, 15 Jun 2023 09:56:56 +0000",
  "from": "+13123456789",
  "from_formatted": "(312) 345-6789",
  "price": null,
  "price_unit": null,
  "sid": "v3:KBnLO0ZK3DhKM5s7bE9VluaSmKsOchKht_fUYvxcp8ysbmzCCtpkmA",
  "start_time": "Thu, 15 Jun 2023 09:56:45 +0000",
  "status": "completed",
  "to": "+13987654321",
  "to_formatted": "(398) 765-4321",
  "uri": "/v2/texml/Accounts/61bf923e-5e4d-4595-a110-56190ea18a1b/Calls/v3:KBnLO0ZK3DhKM5s7bE9VluaSmKsOchKht_fUYvxcp8ysbmzCCtpkmA.json"
}

{
  "errors": [
    {
      "detail": "Resource not found"
    }
  ]
}