Skip to main content
GET
Get candidate dynamic sequence status

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
Returns the latest dynamic sequence for the candidate in their sourcing, including high-level progress and whether user action is required. Use this endpoint after Start sequence blueprint to poll outreach progress by candidateId.

Path parameters

string
required
Candidate id in your workspace.

Response

When success is true, data contains:
  • candidateId, talentId, sourcingId
  • sequence — null when no dynamic sequence exists for this candidate in the sourcing
  • When present, sequence includes sequenceId, name, rawStatus, displayStatus, step progress fields, and optional actionRequired
displayStatus can be SCHEDULED, ACTION_REQUIRED, ERROR, TALENT_REPLIED, WAITING_FOR_ACCEPTANCE, COMPLETED, or PAUSED.
TALENT_REPLIED only describes the dynamic sequence: it is set when a reply interrupts a running dynamic sequence, so it does not cover legacy sequences nor replies received once the sequence is no longer running. To know whether a talent replied at all, regardless of sequence type or timing, use replyStatus returned by Get candidate and List candidates.

Errors