Skip to main content
GET
/
v1
/
candidates
/
{candidateId}
/
dynamic-sequence
Get candidate dynamic sequence status
curl --request GET \
  --url https://app.kalent.ai/api/v1/candidates/{candidateId}/dynamic-sequence \
  --header 'x-api-key: <api-key>'

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

​
candidateId
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.

​
Errors

CodeHTTP
not_found404
internal_error500
curl https://app.kalent.ai/api/v1/candidates/CANDIDATE_ID/dynamic-sequence \
  -H "x-api-key: YOUR_API_KEY"