This is the API V2 documentation. To switch out of beta revert back to our API V1.

Open SidemenuAPI Reference
API Reference
Close Sidemenu

Call Information

Retrieve call statusRetrieveCallStatus

get https://api.telnyx.com/v2/calls/{call_control_id}

Returns the status of a call (data is available 10 minutes after call ended).

curl -X GET \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --globoff "https://api.telnyx.com/v2/calls/{call_control_id}"
Parameters
In path
call_control_id
string
required

Unique identifier and token for controlling the call

Responses
200

Retrieve call status response

default

Unexpected error

Success Response
{
  "data": {
    "call_control_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "call_leg_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "call_session_id": "428c31b6-7af4-4bcb-b7f5-5013ef9657c1",
    "is_alive": true,
    "record_type": "call"
  }
}

Was this section helpful?was-this-page-helpful