---
title: "List outreach activities"
method: GET
path: "/v1/people/{id}/activities"
tags: ["People"]
---

# List outreach activities

`GET /v1/people/{id}/activities`

## Request

- Base URL: `https://api.mentio.dev`
- URL: `https://api.mentio.dev/v1/people/{id}/activities`
- Auth: HTTP bearer

Every logged contact with this person across all their accounts, newest first (at most 200): who reached out, the channel, when, and a short note. Read it before reaching out so two teammates never contact the same person without knowing. With `groupId`, the call works inside that keyword group: its people, and its own tags, notes, mute, merges and activities, apart from the workspace's and from every other group's.

## Path parameters

- `id` string, required: Person id (aut_...).

## Query parameters

- `groupId` string: Scope to one keyword group (grp_...): only people who mentioned that group's keywords, with that group's own tags, notes, mute, merges, activities and segments. Omit for the whole workspace.

## Response `200`

The activities

- object
  - `data` object[], required: Newest first, at most 200.
    - `id` string, required: Activity id (act_...).
    - `personId` string, required: The person it belongs to (aut_...).
    - `channel` 'email' | 'x' | 'linkedin' | 'bluesky' | 'reddit' | 'github' | 'call' | 'meeting' | 'other', required: How they were reached: email, x, linkedin, bluesky, reddit, github, call, meeting or other.
    - `note` string, required: What was sent or said, briefly; empty when nothing was written.
    - `member` object, nullable, required: Who reached out; null when an API key logged it without naming a member, or that member left the workspace.
      - `id` string, required: User id of the workspace member.
      - `name` string, nullable, required
      - `email` string, nullable, required
    - `occurredAt` string, required: When the contact happened.
    - `createdAt` string, required: When it was logged.

## Other responses

- `401`: Missing or invalid API key
- `404`: No mention by this person in this scope, or no such group

---

[API](https://skmtc.dev/mentio/apis/mentio-api.md) · [All operations](https://skmtc.dev/mentio/apis/mentio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mentio/apis/mentio-api/revisions/b16a21d0ed02?raw)
