> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Account Activity

> An account's full timeline, including Clustr's own actions

CRM activity, deals, engagements, and every write Clustr made to the account
(`clustr_action`) — whether a person made it by hand or a [Workflow](/workflows)
made it. See [Record Activity](/record-activity) for what gets logged.

## Path Parameters

<ParamField path="id" type="string" required>
  The account's LinkedIn numeric id.
</ParamField>

## Query Parameters

<ParamField query="types" type="string">
  Comma-separated event types to include (`crm_activity`, `crm_deal`,
  `engagement`, `calendar_event`, `clustr_action`). Omit for all.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/accounts/1035/activity?types=clustr_action" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "events": [
        {
          "type": "clustr_action",
          "subtype": "tier_set",
          "occurred_at": "2026-09-13T09:00:04Z",
          "actor": "workflow:7f1e2a33-...",
          "detail": { "kind": "tier_set", "actor": "workflow:7f1e2a33-...", "detail": { "tierId": "..." } }
        }
      ],
      "has_more": false
    }
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": { "message": "account not found", "code": "NOT_FOUND" }
  }
  ```
</ResponseExample>
