Skip to main content
POST
/
v1
/
candidates
/
{candidateId}
/
enrich-contacts
Enrich candidate contacts
curl --request POST \
  --url https://app.kalent.ai/api/v1/candidates/{candidateId}/enrich-contacts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "enrichmentType": "<string>"
}
'

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.

First time? Set up Authentication

Learn how to authenticate your API requests with your API key.
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

candidateId
string
required
Candidate id in your workspace.

Request body

enrichmentType
string
required
One of phone, personalEmail, or all.

Response

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

Errors

CodeHTTP
validation_error400
missing_enrich_providers400
insufficient_credits402
not_found404
internal_error500
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"}'