# List Interactions

`lawmatics_list-interactions` · Lawmatics MCP tool · Interactions

List interactions from Lawmatics with optional pagination and sorting. Interactions are logged touchpoints (calls, meetings, emails) on a matter; each row carries a `relationships` envelope of to-one {id,type} pointers to the owning record (matter/prospect) and the user who created it.

## Input

- **page** `integer` (> 0) — Page number (1-based)
- **sortBy** `string` (enum: "id", "created_at", "updated_at") — Column to sort by
- **sortOrder** `string` (enum: "asc", "desc") — Sort direction; ascending or descending

## Output

- **interactions** `array` (required) — Interactions on this page of results
  - **[]** `object`
    - **id** `string` (required) — Lawmatics interaction ID
    - **interactionType** `string` (required) — Kind of interaction (free-form label, e.g. "Phone Call", "Meeting")
    - **body** `string` (required) — Text describing the interaction
    - **happenedAt** `string` (required) — When the interaction occurred, as an ISO 8601 timestamp
    - **createdAt** `string` (required) — When the interaction record was created, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the interaction record was last updated, as an ISO 8601 timestamp
    - **relationships** `object` (required) — To-one JSON:API relationship pointers as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own tool (type 'prospect' -> get-matter, type 'user' -> get-user).
      - **interactable** `object | null` (required) — Pointer to the owning record this interaction is logged on (type 'prospect' is a matter); null when unset
        - **id** `string` (required) — ID of the referenced Lawmatics record
        - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
      - **createdBy** `object | null` (required) — Pointer to the Lawmatics user (type 'user') who created the interaction; null when unattributed
        - **id** `string` (required) — ID of the referenced Lawmatics record
        - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
- **pagination** `object` (required) — Pagination metadata derived from the API `meta` envelope
  - **totalPages** `number` (required) — Total number of pages available
  - **limitPerPage** `number` (required) — Maximum interactions returned per page
  - **totalEntries** `number` (required) — Total number of interactions across all pages