v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-054102371.0 MB

Service Agent

List peer_events (raw, unfiltered)

List raw peer_events rows for the service agent's customer, matching either a contact's registered addresses (contact_id) or a single peer address (peer_type + peer_target). Exactly one filter is required.

Unlike GET /service_agents/contact_interactions, this endpoint applies NO identity resolution and NO CRM eligibility filtering: rows may include internal-resource peer types (agent, ai, conference, sip legs) that /service_agents/contact_interactions deliberately excludes. Clients are responsible for any presentation-layer filtering or grouping of this noise.

get/service_agents/contact_peer_events

Query parameters

contact_idstring uuid

Example:550e8400-e29b-41d4-a716-446655440000

Filter by all of a contact's registered addresses. Exactly one of contact_id or peer_type+peer_target is required.

peer_typestring

Example:tel

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

peer_targetstring

Example:+155****4567

Remote endpoint target (e.g. "+155****4567"). Required with peer_type.

page_sizeinteger

Example:25

Number of results to return per page.

page_tokenstring

Cursor token for pagination. Use the next_page_token value from the previous response.

Response

Successful response.

next_page_tokenstring

Pagination token for the next page. Empty when no further pages exist.

Example response

{
  "result": [
    {
      "timestamp": "2026-01-15T10:30:00.123000Z",
      "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
      "publisher": "call",
      "event_type": "call_hangup",
      "reference_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "direction": "incoming",
      "peer": {
        "type": "tel",
        "target": "+14155551234",
        "target_name": "John Smith",
        "name": "Main Office",
        "detail": "Primary contact number"
      },
      "local": {
        "type": "tel",
        "target": "+14155551234",
        "target_name": "John Smith",
        "name": "Main Office",
        "detail": "Primary contact number"
      },
      "data": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    }
  ],
  "next_page_token": "2026-01-15T10:30:00.123000Z"
}