SIP / Calls

Retrieve a SIP call

Retrieve a single SIP call by its identifier.

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

Request

Base URL: https://api.frejun.ai
URL: https://api.frejun.ai/api/v1/sip/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).

sip_trunk_idstring nullable

The SIP trunk the call traversed (st_ 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.

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.

duration_secondsinteger nullable

Billable duration of the primary leg in seconds, once the call has ended.

reasonstring nullable

Machine-readable reason the call ended.

ended_bystring nullable

Which party ended the call.

recordingsstring[]

Recording identifiers (rec_ prefix) captured on this call.

Example response

{
  "account_id": "acc_01JQ8Z9K7M3N2P4R5S6T7V8WIJ",
  "answered_at": "2026-06-01T09:15:12Z",
  "created_at": "2026-06-01T09:15:04Z",
  "direction": "inbound",
  "duration_seconds": 156,
  "ended_at": "2026-06-01T09:17:48Z",
  "ended_by": "caller",
  "from_number": "+14155552671",
  "id": "cs_01JQ8Z9K7M3N2P4R5S6T7V8W9X",
  "reason": "completed",
  "recordings": [
    "rec_01JQ8Z9K7M3N2P4R5S6T7V8WEF"
  ],
  "sip_trunk_id": "st_01JQ8Z9K7M3N2P4R5S6T7V8WMN",
  "state": "completed",
  "to_number": "+14155559876"
}

Changes

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