List candidate notes

Notes on a candidate profile, with author and date.

GET https://cotlet.dev/api/v1/manatal/candidate-notes

read

Returns the notes from the candidate's Notes tab as plain text, newest first, with the author and the time. Notes on jobs and organizations are not included.

Parameters

Parameters: list_candidate_notes
NameTypeDescription
candidate_id integer required integer Candidate ID from search_candidates.
cursor string string Next page cursor from the previous call.

Request

cURL
curl "https://cotlet.dev/api/v1/manatal/candidate-notes?candidate_id=1" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("manatal", "list_candidate_notes", {"candidate_id":1})
Node.js
const result = await cotlet.call('manatal', 'list_candidate_notes', {"candidate_id":1});
CLI
cotlet call manatal list_candidate_notes --data '{"candidate_id":1}'

Example response

JSON

{
  "notes": [
    {
      "note_id": 9120,
      "author": "Lena Fischer",
      "body": "Phone screen done. Wants a remote role.",
      "created_at": "2026-10-05T14:02:00Z"
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.