Get candidate
One candidate record with status, current company and the jobs they were submitted to.
MCP tool bullhorn_read → get_candidate
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. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bullhorn_read",
"arguments": {
"operation": "get_candidate",
"arguments": {
"candidate_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"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"
}
]
},
"isError": false
}