Get candidate
One candidate with title, company, owner, Talent Pools and applications with their stage.
GET https://cotlet.dev/api/v1/vincere/candidates/{candidate_id}
read
Returns the profile of one candidate: current job title and company, owner, the Talent Pools they are in and every application with its job and stage. Check applications before shortlisting, because Vincere counts shortlisted, floated and applied positions toward 1,000 per candidate.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from list_candidates. |
Request
curl https://cotlet.dev/api/v1/vincere/candidates/candidate_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("vincere", "get_candidate", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('vincere', 'get_candidate', {"candidate_id":"candidate_8c41d2"});cotlet call vincere get_candidate --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "88214",
"name": "Priya Nair",
"job_title": "Java Developer",
"current_company": "Northwind Systems",
"owner": "Dana Fox",
"talent_pools": [
"Java"
],
"applications": [
{
"job_id": "1047",
"job_title": "Data Engineer",
"stage": "Applications"
}
]
}