List activities

Comments, meetings and tasks logged on a candidate or a job, with who added them and when.

GET https://cotlet.dev/api/v1/vincere/activities

read

Returns the Activities tab of one record: comments, meetings and tasks with the Action, the notes, the person who logged them and the time. Pass candidate_id or job_id, one of the two. Read it before add_comment so a call is not logged twice.

Parameters

Parameters: list_activities
NameTypeDescription
candidate_id string string Candidate id from list_candidates. Use this or job_id.
job_id string string Job id from list_jobs. Use this or candidate_id.
limit integer integer How many activities to return on one page.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/vincere/activities \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("vincere", "list_activities")
Node.js
const result = await cotlet.call('vincere', 'list_activities');
CLI
cotlet call vincere list_activities

Example response

JSON

{
  "activities": [
    {
      "type": "comment",
      "action": "Phone call | Candidate | Outbound | Connected",
      "notes": "Intro call, interested in contract work.",
      "by": "Dana Fox",
      "at": "2026-10-20T15:12:00"
    }
  ],
  "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.