Signals Docs
Signals API

Your call history. Search it, then read one call in detail: its lifecycle events, a summary of its media and its SIP ladder.


Search customer call history

GET
https://api.signals.pressone.africa
/calls

Search customer call history › query Parameters

q
​string
product
​string · enum
Enum values:
trunking
voice
automation
pressone
trunk
​string
connection_id
​string

A byo_ carrier connection id; only the project's own connections match.

direction
​string · enum
Enum values:
inbound
outbound
status
​string · enum
Enum values:
answered
failed
sip
​string
media
​string · enum

Calls whose media summary shows that fault; affected is either.

Enum values:
one_way
no_media
affected
window
​string · enum
Enum values:
last_hour
last_24h
last_7d
last_30d
cursor
​string
limit
​integer · int32 · min: 0

Search customer call history › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The project the request acts on, as prj_ and its lowercase UUID; optional while the organization has one active project.

Search customer call history › Responses

One page of matching calls.

answered
​integer · int64 · min: 0 · required
as_of
​string · date-time · required
​Call[] · required
failed
​integer · int64 · min: 0 · required
next_cursor
​string | null · required
previous_cursor
​string | null · required
total
​integer · int64 · min: 0 · required

Read one customer call

GET
https://api.signals.pressone.africa
/calls/{call_id}

Read one customer call › path Parameters

call_id
​string · required

Call id

Read one customer call › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The project the request acts on, as prj_ and its lowercase UUID; optional while the organization has one active project.

Read one customer call › Responses

The call with its billing, recordings and evidence.

answered_at
​string | null · date-time · required
direction
​CallDirection · enum · required
Enum values:
inbound
outbound
ended_at
​string | null · date-time · required
from_number
​string · required
has_recording
​boolean · required
id
​string · required
observed_duration_ns
​integer | null · int64 · required
outcome
​CallOutcome · enum · required
Enum values:
answered
unanswered
cancelled
rejected
​CallRating · required
received_at
​string · date-time · required
​CallService · required
sip_call_id
​string | null · required
source_product
​CallSourceProduct · enum · required
Enum values:
trunking
voice
automation
pressone
​required
​CallTermination · required
to_number
​string · required
​required
​CallBilling · required
​required
​required
carrier_leg_ref
​string | null · required
carrier_route
​string | null · required
carrier_sip_summary
​string | null · required

The carrier's final SIP code; set only for a call through a connection.

completeness
​CallCompleteness · enum · required
Enum values:
finalizing
final
connected_from
​string | null · date-time · required
connected_to
​string | null · date-time · required
customer_sip_summary
​string · required
​CallMilestone[] · required
​CallRecording[] · required
​required
trunk_id
​string | null · required

Read a call's public lifecycle events

GET
https://api.signals.pressone.africa
/calls/{call_id}/events

Read a call's public lifecycle events › path Parameters

call_id
​string · required

Call id

Read a call's public lifecycle events › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The project the request acts on, as prj_ and its lowercase UUID; optional while the organization has one active project.

Read a call's public lifecycle events › Responses

Every public lifecycle event of the call.

​CallEvent[] · required

Read a sanitized call media summary

GET
https://api.signals.pressone.africa
/calls/{call_id}/media

Read a sanitized call media summary › path Parameters

call_id
​string · required

Call id

Read a sanitized call media summary › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The project the request acts on, as prj_ and its lowercase UUID; optional while the organization has one active project.

Read a sanitized call media summary › Responses

The media summary, transport evidence and quality perspectives.

anchored
​boolean | null · required
dtmf
​string | null · required
first_rtp_ms
​integer | null · int64 · required
jitter_max_ms
​number | null · double · required
packets_lost
​integer | null · int64 · required
packets_total
​integer | null · int64 · required
rtp_path
​string | null · required
srtp
​boolean | null · required
expires_at
​string | null · date-time · required
imported_at
​string | null · date-time · required
​CallQosSummary · required
reason
​string | null · required
schema_version
​integer · int32 · required
state
​CallDiagnosticState · enum · required
Enum values:
pending
ready
unavailable
expired
​required

Read a sanitized SIP ladder

GET
https://api.signals.pressone.africa
/calls/{call_id}/sip-ladder

Read a sanitized SIP ladder › path Parameters

call_id
​string · required

Call id

Read a sanitized SIP ladder › Headers

Signals-Version
​string · enum · required

The supported API snapshot to use for this request.

Enum values:
2026-10-27
X-Project-ID
​string

The project the request acts on, as prj_ and its lowercase UUID; optional while the organization has one active project.

Read a sanitized SIP ladder › Responses

The sanitized SIP ladder and its import state.

expires_at
​string | null · date-time · required
imported_at
​string | null · date-time · required
invite_headers
​string | null · required
​CallDiagnosticLeg[] · required
​CallSipMessage[] · required
reason
​string | null · required
schema_version
​integer · int32 · required
state
​CallDiagnosticState · enum · required
Enum values:
pending
ready
unavailable
expired