---
title: "List events"
method: GET
path: "/v1/messages/{message_id}/events"
tags: ["Messages"]
---

# List events

`GET /v1/messages/{message_id}/events`

Returns a paginated list of events for the specified message.

## Path parameters

- `message_id` string, required

## Query parameters

- `after` string
- `before` string
- `page_size` integer

## Response `200`

OK

- ListMessageEventsResponse — Returns a paginated list of [delivery and engagement](/send-notifications/message-statuses) events for the specified message.
  - `items` MessageEvent[], required — A list of message events.
    - `__typename` string, required — The typename of the schema.
    - `data` object, nullable — The data associated with the message event. Only present for some event types.
    - `id` string, required — The unique identifier for the message event.
    - `inserted_at` string, date-time, required — Timestamp when the event was created.
    - `recipient` union, required — A reference to a recipient, either a user identifier (string) or an object reference (ID, collection).
      - string — The ID of the user which is used as the reference for the recipient.
      - object — A reference to a recipient object.
        - `collection` string — The collection the recipient object belongs to.
        - `id` string — An identifier for the recipient object.
    - `type` 'message.archived' | 'message.bounced' | 'message.created' | 'message.delivered' | 'message.delivery_attempted' | 'message.interacted' | 'message.link_clicked' | 'message.not_sent' | 'message.queued' | 'message.read' | 'message.seen' | 'message.sent' | 'message.unarchived' | 'message.undelivered' | 'message.unread' | 'message.unseen', required — The type of event that occurred.
  - `page_info` PageInfo, required — Pagination information for a list of resources.
    - `__typename` string, required — The typename of the schema.
    - `after` string, nullable — The cursor to fetch entries after.
    - `before` string, nullable — The cursor to fetch entries before.
    - `page_size` integer, required — The number of items per page (defaults to 50).

---

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