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

> Load candidate metadata with secured talent data and contact loading flags.

## Input

| Parameter     | Type   | Required | Description            |
| ------------- | ------ | -------- | ---------------------- |
| `candidateId` | string | Yes      | Candidate id to fetch. |

## Output

JSON block with `success: true` and nested `candidate` plus secured `talent`. Contact objects are not returned directly: visible emails are exposed as `talent.emails`, and visible sanitized phone numbers are exposed as `talent.phones`. The response also includes `contactsLoading` for email and phone while enrichment jobs run.

The candidate object exposes `sourcingId` for the sourcing that owns the candidate.

The talent object does not include internal LinkedIn/email/WhatsApp interaction flags.

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

## Errors

`session not found` or `Not found` when the candidate is outside the session workspace.