Skip to main content
GET
/
v1
/
candidates
/
{candidateId}
Get candidate
curl --request GET \
  --url https://app.kalent.ai/api/v1/candidates/{candidateId} \
  --header 'x-api-key: <api-key>'

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

​
candidateId
string
required
Candidate id belonging to the API key workspace.

​
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

CodeHTTP
not_found404
internal_error500
curl -X GET https://app.kalent.ai/api/v1/candidates/CANDIDATE_ID \
  -H "x-api-key: YOUR_API_KEY"