Skip to main content
GET
Get lead history with node details
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. Use the /v1 version for new integrations. This endpoint remains available for existing integrations until then.
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.

Headers

x-organization-id
string
required

RSA encrypted organization ID (base64 format)

Example:

"BASE64_ENCRYPTED_ORG_ID_HERE"

Path Parameters

workflowId
string
required
id
string
required

Response

Lead history fetched successfully