Sign in
Interaction

Get an interaction

Get the interaction of the given ID.

get/interactions/{id}

Path parameters

idstring uuid required
Example:550e8400-e29b-41d4-a716-446655440000

The ID of the interaction. The ID is returned from GET /interactions response.

Response

Successful response.

idstring uuid

Unique identifier for the interaction.

customer_idstring uuid

Unique identifier of the associated customer.

direction'incoming' | 'outgoing'

Direction of the interaction from the platform perspective.

peer_typestring

Remote endpoint type (e.g. "tel", "email").

peer_targetstring

Remote endpoint address (normalized, e.g. "+155****4567").

local_typestring

Local endpoint type (e.g. "tel").

local_targetstring

Local endpoint address (e.g. the DID that received the call).

reference_typestring

Origin channel type (e.g. "call", "conversation").

reference_idstring uuid

ID of the origin channel record (call_id or conversation_id).

tm_interactionstring date-time

Origin event time (from the channel record). Nullable.

tm_createstring date-time

Timestamp when this interaction was recorded (projection insert time, used as pagination cursor).

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "direction": "incoming",
  "peer_type": "tel",
  "peer_target": "+155****4567",
  "local_type": "tel",
  "local_target": "+12025550100",
  "reference_type": "call",
  "reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tm_interaction": "2026-06-01T09:30:00.000000Z",
  "tm_create": "2026-06-01T09:30:01.000000Z"
}

Changes