Workflow Leads
Get Workflow Lead History
Fetch the node-by-node execution history for one workflow lead.
GET
Get Lead Execution History
Read only
Returns the complete history of a single lead’s path through the workflow. Each entry records a node the lead entered: the
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.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.
call_id returned by this endpoint with Get Call Details.
Path parameters
Errors
404 Not Foundis returned when the workflow or lead does not exist, or the lead is not enrolled in the workflow.
Related endpoints
- List Workflow Leads: see every lead in the workflow.
- Get Call Details: full transcript for the
call_idreturned above. - Get Workflow Details: workflow summary alongside per-lead drill-downs.
- List Nodes: fetch node definitions referenced in the history.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workflow ID
Example:
"workflow_abc123"
Lead ID
Example:
"lead_abc123"
Response
Lead execution history returned successfully.
Get Lead Execution History