Get candidate
One candidate profile: applications, stage, notes, recent emails and scheduled interviews.
GET https://cotlet.dev/api/v1/ashby/candidates/{candidate_id}
read
Returns the profile fields Ashby shows on the candidate page, plus every application with its stage and archive reason if archived. Notes and emails come newest first. Private fields appear only if your account can see them.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate ID from search_candidates. |
Request
curl https://cotlet.dev/api/v1/ashby/candidates/candidate_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("ashby", "get_candidate", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('ashby', 'get_candidate', {"candidate_id":"candidate_8c41d2"});cotlet call ashby get_candidate --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "e1f7a309-4c52-4d8b-a063-9b25d7c1e840",
"name": "Ana Costa",
"email": "ana.costa@example.com",
"source": "Referral",
"applications": [
{
"application_id": "9c41b7a2-6e03-4d58-a1f9-3b8d25e07c64",
"job": "Product Designer",
"stage": "Offer",
"status": "Active",
"offer": null
}
],
"notes": [
{
"author": "Priya Nair",
"created_at": "2026-10-14T10:12:00+02:00",
"text": "Strong portfolio, wants a start in mid November."
}
],
"recent_emails": [
{
"direction": "sent",
"subject": "Next steps",
"sent_at": "2026-10-12T09:30:00+02:00"
}
],
"interviews": [
{
"interview": "Design review",
"start": "2026-10-13T15:00:00+02:00",
"status": "Completed"
}
]
}