List candidate activity

Comments, emails, meetings and status changes from a candidate's activity log.

GET https://cotlet.dev/api/v1/comeet/candidate-activities

read

Returns the entries of the activity log, newest first, 30 to a page. filter picks what Recruit's log filters show: recent, internal, candidate, screening_and_interviews. Comments hidden from your role are not returned.

Parameters

Parameters: list_candidate_activity
NameTypeDescription
candidate_id string required string Candidate from list_candidates.
filter enum enum recent (default), internal, candidate or screening_and_interviews.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "entries": [
    {
      "type": "comment",
      "author": "Ravi Shah",
      "body": "@Dana Cho please decide on this one",
      "visibility": "position_recruiters",
      "at": "2026-10-19T09:12:00Z"
    },
    {
      "type": "status_change",
      "author": "Ravi Shah",
      "body": "Moved to Hiring manager screen",
      "at": "2026-10-16T08:40: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.