Docs
OverviewGuidesZero & MCPAPI referenceChangelog
Calls

List Lead Calls

The lead's calls, newest first. 404 for a missing, deleted or other-workspace lead.

API key access

Needs the calls:read scope with an API key (ro_pat_...). A signed-in session uses the caller's role.
GET/api/v1/leads/{lead_id}/calls

Authorization

AuthorizationBearer <token>

Access token from /api/v1/auth/login, or an API key (ro_pat_..., RO-176) from /api/v1/workspaces/current/api-keys: the key implies its workspace and needs the route's scope. MCP connectors (/api/v1/mcp only) may use an OAuth access token (ro_oat_..., RO-284).

In: header

Path Parameters

lead_idstring
Formatuuid

Query Parameters

cursor?string | null
Lengthlength <= 64
limit?integer
Formatint64
Range1 <= value <= 200

Header Parameters

X-Workspace-Id?string | null

Id of the workspace to act on (must be a member).

Response Body

curl -X GET "http://localhost:8000/api/v1/leads/497f6eca-6276-4993-bfeb-53cbbbba6f08/calls?cursor=string&limit=1" \  -H "X-Workspace-Id: string"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",
      "lead_id": "9bddab70-98e6-43a9-8f32-c9788b9de0c0",
      "direction": "outbound",
      "status": "queued",
      "outcome": {},
      "qualification_fields": [
        {
          "property1": null,
          "property2": null
        }
      ],
      "answers": {
        "property1": "string",
        "property2": "string"
      },
      "summary": "string",
      "callback_requested": true,
      "callback_preferred_time": "string",
      "callback_reason": "string",
      "handoff_requested": true,
      "handoff_reason": "string",
      "opted_out_at": "2019-08-24T14:15:22Z",
      "provider": "string",
      "provider_call_id": "string",
      "from_number": "string",
      "to_number": "string",
      "recording_ref": "string",
      "started_at": "2019-08-24T14:15:22Z",
      "ended_at": "2019-08-24T14:15:22Z",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "analysis_status": {},
      "ai_summary": "string",
      "is_test": true
    }
  ],
  "next_cursor": "string"
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

List Calls

The workspace's calls (of live leads), newest first, each with its lead summary. `since` / `until` bound `created_at` (inclusive / exclusive; no offset = UTC).

Company Engagement

Record view 2.0 (RO-335): the company's overview (state, last touch and reply, open deals, next step), its people ordered by engagement with gaps flagged (a decision maker gone quiet, no reply after several touches), and touchpoints per week for the last 12 weeks.