List candidate notes
Notes on a candidate's Notes tab with Note Action, author and date, newest first.
GET https://cotlet.dev/api/v1/bullhorn/candidate-notes
read
Reads the Notes tab of one candidate, newest first. Each note has its Note Action, the Comments text, who added it and when, and the records it references. Use it before add_note to avoid doubling a note.
Parameters
| Name | Type | Description |
|---|---|---|
| candidate_id integer required | integer | Candidate ID from search_candidates or find_matching_candidates. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl "https://cotlet.dev/api/v1/bullhorn/candidate-notes?candidate_id=1" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bullhorn", "list_candidate_notes", {"candidate_id":1})const result = await cotlet.call('bullhorn', 'list_candidate_notes', {"candidate_id":1});cotlet call bullhorn list_candidate_notes --data '{"candidate_id":1}'Example response
{
"notes": [
{
"note_id": 6120044,
"note_action": "Phone Call",
"comments": "Open to contract. Free from 3 Nov.",
"added_by": "Dana Whitfield",
"added_at": "2026-10-22T15:40:00Z",
"references": [
{
"type": "job",
"id": 77314
}
]
}
],
"next_cursor": null
}