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

# Enrich candidate contacts

> Start phone or email enrichment for the talent behind 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>

Triggers asynchronous contact enrichment for the talent linked to the candidate. Your workspace must have enrichment providers configured. Credits apply unless the user is a super-admin.

## Path parameters

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

## Request body

<ParamField body="enrichmentType" type="string" required>
  One of `phone`, `personalEmail`, or `all`.
</ParamField>

## Response

When `success` is `true`, `data` includes `candidateId`, `talentId`, and `enrichmentType` (mirrors the request kind).

## Errors

| Code                       | HTTP |
| -------------------------- | ---- |
| `validation_error`         | 400  |
| `missing_enrich_providers` | 400  |
| `insufficient_credits`     | 402  |
| `not_found`                | 404  |
| `internal_error`           | 500  |

```bash theme={null}
curl -X POST https://app.kalent.ai/api/v1/candidates/CANDIDATE_ID/enrich-contacts \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"enrichmentType":"all"}'
```