Get Call

Return the current state of a call.

Endpoint

GET https://api.tryvox.io/v1/voice/accounts/{auth_id}/calls/{call_uuid}

{call_uuid} is the value returned in the request_uuid field on call creation, on List Calls, or on inbound answer_url payloads.

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/calls/550e8400-e29b-41d4-a716-446655440000

Response

200 OK:

{
  "data": {
    "request_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "TJab12cd34",
    "auth_id": "TJab12cd34",
    "from": "+14155551234",
    "to": "+14155556789",
    "direction": "outbound",
    "status": "completed",
    "start_time": "2026-04-09T10:30:00Z",
    "answer_time": "2026-04-09T10:30:05Z",
    "end_time": "2026-04-09T10:32:10Z",
    "duration": 125,
    "billsec": 125,
    "hangup_cause": "NORMAL_CLEARING"
  }
}

Response fields

• request_uuid — stable identifier for the call.
• account_id / auth_id — the account's Auth ID.
• from, to — E.164 numbers.
• direction — outbound or inbound.
• status — see List Calls → Status values.
• start_time — when the call request was accepted.
• answer_time — when the call connected. Omitted on calls that never answered.
• end_time — when the call ended. Omitted while the call is in progress.
• duration — total wall-clock seconds.
• billsec — billable seconds (answer to end). 0 for calls that didn't connect.
• hangup_cause — SIP-style cause when ended; empty while in progress.

Errors

Notes

• Pricing is not on this object. Per-call cost is reported in the CDR webhook delivered to your hangup_url. The CDR payload includes cost, currency, mos, jitter, and packet_loss.
• Recording URLs are not on this object. Recordings arrive via the recording callback_url you registered on Start Recording. See Recordings.
• In-progress fields (answer_time, end_time, hangup_cause) only appear once the underlying lifecycle event has fired.