Get candidate
One candidate with contact details, tags, custom fields, jobs with stages and latest notes.
GET https://cotlet.dev/api/v1/recruiterflow/candidates/{candidate_id}
read
Returns one profile: name, title, company, location, tags, custom fields, owner, the jobs they are on with the current stage and status in each, and the latest notes. Private notes show only if your user may see them. Use list_activities for the full history.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from list_candidates or list_job_candidates. |
Request
curl https://cotlet.dev/api/v1/recruiterflow/candidates/candidate_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("recruiterflow", "get_candidate", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('recruiterflow', 'get_candidate', {"candidate_id":"candidate_8c41d2"});cotlet call recruiterflow get_candidate --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "772318",
"name": "Dana Whitfield",
"title": "Product Designer",
"company": "Brightline",
"location": "London",
"email": "dana.whitfield@example.com",
"tags": [
"design-lead"
],
"custom_fields": {
"notice_period": "4 weeks"
},
"jobs": [
{
"job_id": "48307",
"title": "Product Designer",
"stage": "Phone Screen",
"status": "active"
}
],
"notes": [
{
"note_id": "90412",
"body": "Intro call booked for Thursday.",
"private": false,
"created_at": "2026-10-20T09:12:00Z"
}
]
}