Voice / Calls

Retrieve a call

Retrieve a single call by its identifier, including its legs.

get/api/v1/voice/calls/{call_id}

Request

  • Base URL: https://api.frejun.ai
  • URL: https://api.frejun.ai/api/v1/voice/calls/{call_id}
  • Auth: API key in header x-api-key

Path parameters

call_idstring required

Response

Successful Response

idstring required

Unique identifier for the call (cs_ prefix).

account_idstring required

The account that owns the call (acc_ prefix).

voice_app_idstring nullable

The voice app that handled the call (va_ prefix), if any.

state'initiated' | 'ringing' | 'answered' | 'completed' | 'failed' required
direction'inbound' | 'outbound' required
from_numberstring nullable

Caller number in E.164 format.

to_numberstring nullable

Called number in E.164 format.

propertiesobject

Arbitrary metadata you attached when initiating the call.

created_atstring date-time required

When the call was created.

answered_atstring date-time nullable

When the call was answered, if it was.

ended_atstring date-time nullable

When the call ended, if it has.

reasonstring nullable

Machine-readable reason the call ended.

Example response

{
  "account_id": "acc_01JQ8Z9K7M3N2P4R5S6T7V8WIJ",
  "answered_at": "2026-06-01T09:15:12Z",
  "created_at": "2026-06-01T09:15:04Z",
  "direction": "outbound",
  "from_number": "+14155552671",
  "id": "cs_01JQ8Z9K7M3N2P4R5S6T7V8W9X",
  "legs": [],
  "properties": {},
  "state": "answered",
  "to_number": "+14155559876",
  "voice_app_id": "va_01JQ8Z9K7M3N2P4R5S6T7V8WKL"
}

Changes

No recorded changes to this operation across all 1 revision of this API.