> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get candidate dynamic sequence status

> Read the current or latest dynamic outreach sequence status for a candidate.

<Card title="First time? Set up Authentication" icon="key" href="/authentication">
  Learn how to authenticate your API requests with your API key.
</Card>

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](/api-reference/start-sequence-blueprint) to poll outreach progress by `candidateId`.

## Path parameters

<ParamField path="candidateId" type="string" required>
  Candidate id in your workspace.
</ParamField>

## 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

| Code             | HTTP |
| ---------------- | ---- |
| `not_found`      | 404  |
| `internal_error` | 500  |

```bash theme={null}
curl https://app.kalent.ai/api/v1/candidates/CANDIDATE_ID/dynamic-sequence \
  -H "x-api-key: YOUR_API_KEY"
```