Get candidate
One candidate with profile details, status, workflow steps and tags.
GET https://cotlet.dev/api/v1/comeet/candidates/{candidate_id}
read
Returns the profile fields Recruit shows (contact details, source, position, application answers when present), the status, the workflow with each step done or pending, scheduled interviews and tags. Resume files are not returned, only their names. Roles that may not see a hired candidate's evaluations get none.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate from list_candidates. |
Request
curl https://cotlet.dev/api/v1/comeet/candidates/candidate_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("comeet", "get_candidate", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('comeet', 'get_candidate', {"candidate_id":"candidate_8c41d2"});cotlet call comeet get_candidate --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "cand_3b90e4",
"name": "Priya Nair",
"position": "Senior Product Designer",
"status": "in_progress",
"source": "Careers website",
"workflow": [
{
"step": "Application review",
"state": "done"
},
{
"step": "Interview with hiring manager",
"state": "pending",
"invitation": null
}
],
"scheduled_interviews": [],
"tags": [
"portfolio strong"
],
"resume_files": [
"priya-nair-cv.pdf"
]
}