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

> Fetch a candidate with secured talent profile and contact loading flags.

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

Returns candidate metadata plus a talent payload processed through the same contact-visibility rules as the product UI. Contact objects are not returned directly: visible emails are exposed as `talent.emails`, and visible sanitized phone numbers are exposed as `talent.phones`. While enrichment is pending, `talent.contactsLoading.email` and `talent.contactsLoading.phone` indicate loading state.

## Path parameters

<ParamField path="candidateId" type="string" required>
  Candidate id belonging to the API key workspace.
</ParamField>

## Response

When `success` is `true`, `data` contains:

* `candidate` — `id`, `statusHandle`, `createdAt`, `sourcingId`, `talentId`
* `talent` — secured talent fields plus `emails`, `phones`, and `contactsLoading`. Internal LinkedIn/email/WhatsApp interaction flags are not returned.

The response does not expose internal `workspaceId` or `userId` fields.

## Errors

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

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