Skip to main content
GET
Get Lead Execution History
Read only
Recommended. This endpoint is part of the public /v1 API reference and is the supported path for new integrations. See the migration guide for versioning guidance.
Returns the complete history of a single lead’s path through the workflow. Each entry records a node the lead entered: the node_id, the node_type, the human-readable label, the start and end timestamps, the per-step status, and, for VOICE_CALL nodes, the call_id so you can pivot into Get Call Details to inspect the transcript. Use this endpoint for per-lead debugging, quality review, and rendering a timeline view in your dashboard.

When to use this

  • Debugging a stuck lead: confirm which node the lead is waiting on and how long it has been there.
  • Quality review: produce a per-lead timeline for compliance or operations reviewers.
  • Drill-down from a dashboard: pivot from a workflow lead row into the full path the lead took.
  • Reporting on path coverage: sample lead histories to confirm conditional branches are being followed as expected.
For aggregate lead progress across the workflow, use List Workflow Leads. For the call log of a specific voice-call step, use the call_id returned by this endpoint with Get Call Details.

Path parameters

Errors

  • 404 Not Found is returned when the workflow or lead does not exist, or the lead is not enrolled in the workflow.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

workflowId
string
required

Workflow ID

Example:

"workflow_abc123"

id
string
required

Lead ID

Example:

"lead_abc123"

Response

Lead execution history returned successfully.