---
title: "List Events"
method: GET
path: "/v2/events"
tags: ["external", "external-v2"]
---

# List Events

`GET /v2/events`

List events for the authenticated account in sequence order.
Events are a stable external projection over Mem domain events. They are
thin by default; fetch full object state with the corresponding read API.

## Query parameters

- `after_sequence` integer — Return events with a sequence greater than this value. Store `next_after_sequence` from each response as the next watermark.
- `limit` integer — Maximum number of events to return. Max: 1000.
- `types` ExternalEventType[], nullable — Optional repeated event type filter, for example `?types=mem.note.created.v1&types=mem.conversation.message_received.v1`.
- `entity_kind` string, nullable — Optional primary entity kind filter, such as `note`.
- `entity_id` string, uuid, nullable — Optional primary entity UUID filter.

## Response `200`

OK

- EventListResponseSchema
  - `has_more` boolean, required — Whether more matching events are available after this page.
  - `high_watermark` integer, required — Highest sequenced event currently visible for this account.
  - `next_after_sequence` integer, required — Watermark to pass as `after_sequence` on the next poll. When no more matching events are currently available, this advances to the account high watermark.
  - `request_id` string, required — Identifier for this API request. Useful for tracing and support.
  - `results` EventResponseSchema[], required — Events in sequence order.
    - `data` object, required — Thin event payload. Fetch full object state with read tools.
    - `id` string, uuid, required — Stable UUID for this event.
    - `occurred_at` string, date-time, required — Timestamp for when the event occurred.
    - `primary_entity` EventPrimaryEntityResponseSchema, required
      - `id` string, uuid, required — UUID of the primary entity.
      - `kind` string, required — External kind for the primary entity.
    - `sequence` integer, required — Per-account sequence number. Use as the event log watermark.
    - `subject` string, nullable, required — Stable subject pointer for routing or deduplication.
    - `type` 'mem.note.created.v1' | 'mem.note.content_changed.v1' | 'mem.note.editing_session_ended.v1' | 'mem.note.deleted.v1' | 'mem.calendar_event.created.v1' | 'mem.calendar_event.updated.v1' | 'mem.calendar_event.deleted.v1' | 'mem.audio_recording.created.v1' | 'mem.audio_recording.transcribed.v1' | 'mem.follow_up.due.v1' | 'mem.conversation.message_received.v1' | 'mem.routine.reminder_due.v1' | 'mem.email.received.v1' | 'mem.chat.reaction.v1' | 'mem.slack.account_linked.v1' | 'mem.calendar.connected.v1' | 'mem.conversation.idle.v1', required

---

[API](https://skmtc.net/mem/apis/mem-api.md) · [All operations](https://skmtc.net/mem/apis/mem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mem/mem-api/revisions/4023cb07f31f/schema)