Get candidate
One candidate record with skills, employment history, applications and recent notes.
GET https://cotlet.dev/api/v1/jobadder/candidates/{candidate_id}
read
Returns the profile of one candidate: contact details, skills, employment history and education, their applications with job and status, and the most recent notes. A candidate your JobAdder user cannot open returns APP_PERMISSION_DENIED. Attachments such as the original resume file are not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id string required | string | Candidate id from search_candidates or list_job_applications. |
Request
curl https://cotlet.dev/api/v1/jobadder/candidates/candidate_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("jobadder", "get_candidate", {"candidate_id":"candidate_8c41d2"})const result = await cotlet.call('jobadder', 'get_candidate', {"candidate_id":"candidate_8c41d2"});cotlet call jobadder get_candidate --data '{"candidate_id":"candidate_8c41d2"}'Example response
{
"candidate_id": "cand_20931",
"name": "Priya Nair",
"email": "priya.nair@example.com",
"skills": [
"Financial reporting",
"Xero",
"Month-end close"
],
"employment": [
{
"title": "Senior Accountant",
"company": "Harbour Partners",
"years": "2020-2026"
}
],
"applications": [
{
"application_id": "app_48213",
"job": "Senior Accountant",
"status": "Phone screen"
}
],
"notes": [
{
"note_id": "note_77310",
"text": "Referred by a client.",
"created_at": "2026-10-14T09:12:00+11:00"
}
]
}