Phone Calls

List Agent Calls

get/api/v1/phone/calls

Query parameters

agent_identity_idstring uuid nullable

Agent identity to list calls for. Agent-scoped keys resolve their own; required for admin/JWT.

Agent identity to list calls for. Agent-scoped keys resolve their own; required for admin/JWT.

limitinteger
offsetinteger
is_blockedboolean nullable
start_datetimestring nullable

Filter created_at >= this date/datetime. Bare date => whole day in tz.

Filter created_at >= this date/datetime. Bare date => whole day in tz.

end_datetimestring nullable

Filter created_at <= this date/datetime. Bare date => whole day inclusive.

Filter created_at <= this date/datetime. Bare date => whole day inclusive.

tzstring nullable

IANA zone (e.g. America/New_York) for zone-less values; default UTC.

IANA zone (e.g. America/New_York) for zone-less values; default UTC.

Response

Successful Response

idstring uuid required
origin'dedicated_number' | 'shared_imessage_number' | 'dedicated_imessage_number'
local_phone_numberstring nullable
remote_phone_numberstring required
direction'outbound' | 'inbound' required
status'initiated' | 'ringing' | 'answered' | 'completed' | 'failed' | 'canceled' required
client_websocket_urlstring nullable required
mode'client_websocket' | 'hosted_agent'
hosted_agent_authority_mode'contact_scoped' | 'yolo'
voicemail_detection'enabled' | 'disabled'
reasonstring nullable
use_inkbox_ttsboolean nullable required
use_inkbox_sttboolean nullable required
hangup_reason'local' | 'remote' | 'max_duration' | 'voicemail' | 'rejected' | 'failed'
started_atstring date-time nullable required
ended_atstring date-time nullable required
is_blockedboolean
created_atstring date-time required
updated_atstring date-time required

Changes

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