List notes
Lists the notes in a candidate's profile story.
GET https://cotlet.dev/api/v1/lever/opportunities/{opportunity_id}/notes
read
Returns the notes of all the candidate's opportunities, newest first, with the author, date and text. Secret notes appear only when your Lever role may see them. A next_cursor is returned while more notes remain.
Parameters
| Name | Type | Description |
|---|---|---|
| opportunity_id string required | string | Opportunity ID from list_opportunities. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/lever/opportunities/opportunity_8c41d2/notes \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("lever", "list_notes", {"opportunity_id":"opportunity_8c41d2"})const result = await cotlet.call('lever', 'list_notes', {"opportunity_id":"opportunity_8c41d2"});cotlet call lever list_notes --data '{"opportunity_id":"opportunity_8c41d2"}'Example response
{
"notes": [
{
"note_id": "a8f1d0c3-6e2b-4b79-8c15-0d9e3f7a2b46",
"author": "Sam Okafor",
"created_at": "2026-10-16T09:22:00Z",
"secret": false,
"text": "Portfolio is strong on mobile flows."
}
],
"next_cursor": null
}