List Calls

Returns calls associated with the authenticated account, newest first.

Endpoint

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

Query parameters

Today only status is honoured server-side; the other filters are accepted but applied client-side in your code. Pagination is not yet implemented — large accounts should narrow with status to keep response size manageable.

Example request

curl -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  "https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/calls?status=completed"

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"
    }
  ]
}

If no calls match, data is [].

Response fields

• request_uuid — identifier for the original API request that started this call. Use it for cross-referencing with logs and webhook payloads.
• account_id / auth_id — both equal to the account's Auth ID.
• from, to — E.164 numbers.
• direction — outbound or inbound.
• status — current call status.
• start_time — when the request was accepted (UTC ISO 8601).
• answer_time — when the call connected. Omitted if the call never answered.
• end_time — when the call ended. Omitted while in progress.
• duration — wall-clock seconds from start_time to end_time.
• billsec — billable seconds (from answer_time to end_time). 0 for unanswered calls.
• hangup_cause — SIP-style cause string (NORMAL_CLEARING, USER_BUSY, NO_ANSWER, CALL_REJECTED, etc.).

Status values

• queued — call accepted, awaiting dispatch
• ringing — destination is ringing
• in-progress — answered, in progress
• completed — finished normally
• failed — never connected
• busy — destination returned busy
• no-answer — ring timeout elapsed without answer
• canceled — terminated before answer (e.g. via Hangup)

Notes

• The response shape lacks a call_uuid today. Use request_uuid as the stable identifier across this list, Get Call, and webhook payloads.
• Recording URLs are delivered separately via the recording callback_url, not on this call object. See Recordings.