Get Call Details

Retrieve detailed information about a specific call using its unique identifier.

Endpoint

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

Path Parameters

• auth_id - Your account authentication ID
• call_uuid - The unique identifier of the call

Example Request

curl -X GET https://api.tryvox.io/v1/voice/accounts/your_auth_id/calls/650e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer tvx_sk_live_..."

Response

{
  "call_uuid": "650e8400-e29b-41d4-a716-446655440000",
  "request_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "from": "+14155551234",
  "to": "+14155556789",
  "direction": "outbound",
  "status": "completed",
  "duration": 125,
  "billed_duration": 126,
  "start_time": "2026-04-09T10:30:00Z",
  "ring_time": "2026-04-09T10:30:02Z",
  "answer_time": "2026-04-09T10:30:05Z",
  "end_time": "2026-04-09T10:32:10Z",
  "end_reason": "caller-hangup",
  "price": "0.0130",
  "price_unit": "USD",
  "answer_url": "https://example.com/answer",
  "hangup_url": "https://example.com/hangup",
  "ring_url": "https://example.com/ringing",
  "machine_detection": "Enable",
  "machine_detection_result": "human",
  "recording_urls": [
    "https://recordings.tryvox.io/650e8400-e29b-41d4-a716-446655440000.mp3"
  ],
  "parent_call_uuid": null,
  "transfer_time": null
}

Response Fields

Basic Information

• call_uuid - Unique identifier for this call
• request_uuid - Unique identifier for the original API request
• from - Caller number (E.164 format)
• to - Destination number (E.164 format)
• direction - Call direction (outbound or inbound)
• status - Current call status

Timing Information

• duration - Actual call duration in seconds (from answer to end)
• billed_duration - Duration used for billing in seconds (typically rounded up)
• start_time - When the call was initiated
• ring_time - When the call started ringing
• answer_time - When the call was answered
• end_time - When the call ended
• end_reason - Reason the call ended

Billing Information

• price - Cost of the call
• price_unit - Currency unit (USD, EUR, etc.)

Configuration

• answer_url - Webhook URL called when answered
• hangup_url - Webhook URL called when ended
• ring_url - Webhook URL called when ringing
• machine_detection - Whether machine detection was enabled
• machine_detection_result - Result if enabled (human, machine, unknown)

Recording and Transfer

• recording_urls - Array of recording URLs (if call was recorded)
• parent_call_uuid - UUID of parent call if this call was transferred
• transfer_time - Timestamp when call was transferred (if applicable)

Status Values

• queued - Call is queued for processing
• ringing - Call is ringing
• in-progress - Call is active
• completed - Call ended successfully
• failed - Call failed to connect
• busy - Callee was busy
• no-answer - Call was not answered
• canceled - Call was canceled before answer

End Reason Values

• caller-hangup - Caller ended the call
• callee-hangup - Callee ended the call
• timeout - Call exceeded time limit
• error - Technical error occurred
• rejected - Call was rejected
• transferred - Call was transferred

Notes

• Call details remain available for 90 days after the call ends
• Recording URLs are accessible for 30 days by default
• Pricing is calculated based on billed duration and destination