Voice

List dialer calls (filter by contact, SDR, or session)

Return up to limit recent dialer call summaries.

At least ONE of (contact_id, user_email, parallel_session_id) MUST be supplied - org id alone is not a valid filter (would firehose the entire org's call history). 422 otherwise.

Summary rows do NOT include the transcript blob (5-50 KB each). Use has_transcript to decide whether to fetch the full transcript via GET /voice/dialer/calls/{room_name}/transcript.

Org isolation is enforced server-side by the voice route: the org id on the API key is forwarded as a required query param, so a call row from another tenant cannot leak into the response.

get/voice/dialer/calls

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/voice/dialer/calls
  • Auth: HTTP bearer

Query parameters

contact_idstring nullable

CDP contact id (string form of mashup_contacts.id). If you only have a CRM-overlay id (cb_contact_extensions.id), resolve it via the contacts endpoint first. Optional - supply at least one of contact_id, user_email, or parallel_session_id.

user_emailstring nullable

SDR email. Returns dialer calls where the parent ParallelDialSession.user_email matches. Use for incremental ingestion of one SDR's call history.

parallel_session_idstring nullable

Filter to a single ParallelDialSession.session_id.

created_afterstring nullable

ISO-8601 timestamp. Only return calls with created_at >= this value. Use for incremental polling (pass the max created_at from the previous page on the next call).

limitinteger

Max calls to return, newest first. Capped at 100.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Response

Successful Response

Changes

No recorded changes to this operation across all 2 revisions of this API.