Workflow Leads
Get Lead History
deprecated
View the step-by-step path of a single lead through a workflow, including every node entered, outcomes, and time spent at each step.
GET
Get lead history with node details
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.
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: 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.
Headers
RSA encrypted organization ID (base64 format)
Example:
"BASE64_ENCRYPTED_ORG_ID_HERE"
Response
Lead history fetched successfully
Get lead history with node details