Retrieve a candidate's step timeline
GET/v1/flows/:flow_id/candidates/:candidate_id/steps
What has happened to this candidate on each step they have reached: when it was scheduled, sent, replied to, bounced or skipped, and the tasks it raised. A step the candidate has not reached is absent rather than empty, and a step still awaiting review of its AI-written message is left out until it is approved.
Request
Responses
- 200
- 401
- 403
- 404
Timeline retrieved
Missing or invalid bearer token.
The public API is not enabled for this account (err_feature_not_enabled), the acting user is not allowed to view this flow, or the API key lacks the flows:read scope (err_insufficient_scope).
Flow not found (err_flow_not_found), or the candidate is not in the flow (err_candidate_not_in_flow).