Get candidate
One candidate record with status, current company and the jobs they were submitted to.
GET https://cotlet.dev/api/v1/bullhorn/candidates/{candidate_id}
read
Returns the candidate's name, occupation, current company, status and contact fields, plus one row per submission with the job and its status. Notes are not included; list_candidate_notes reads the Notes tab. A candidate you cannot open in Bullhorn answers APP_PERMISSION_DENIED.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_matching_candidates. |
Request
curl https://cotlet.dev/api/v1/bullhorn/candidates/1 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bullhorn", "get_candidate", {"candidate_id":1})const result = await cotlet.call('bullhorn', 'get_candidate', {"candidate_id":1});cotlet call bullhorn get_candidate --data '{"candidate_id":1}'Example response
{
"candidate_id": 4821907,
"name": "Priya Raman",
"occupation": "Data Analyst",
"company": "Brightpath Retail",
"status": "Active",
"email": "priya.raman@example.com",
"submissions": [
{
"submission_id": 905512,
"job_id": 77314,
"job_title": "Senior Data Analyst",
"status": "Submitted"
}
]
}