---
title: "List EventResponse"
method: GET
path: "/organizations/{orgId}/events"
tags: ["Events"]
---

# List EventResponse

`GET /organizations/{orgId}/events`

List all Events.

Retrieve a list of all Events, with options to filter the returned list based on various criteria. Each Event represents a unique instance of a state change within the system, classified under a specific kind of Event.

**NOTES:** You can:
* Use `eventName` as a valid Query parameter to filter the list of Events returned. For example:
`.../organizations/{orgId}/events?eventName=configuration.commitment.created`
* Use the [List Notification Events](https://www.m3ter.com/docs/api#tag/Events/operation/ListEventTypes) endpoint in this section. The response lists the valid Query parameters.

## Path parameters

- `orgId` string, required

## Query parameters

- `pageSize` integer
- `ids` string[]
- `notificationId` string
- `accountId` string
- `eventType` string
- `notificationCode` string
- `includeActioned` boolean
- `nextToken` string
- `eventName` string, nullable
- `resourceId` string, nullable

## Response `200`

Returns list of Events

- PaginatedEventResponseData
  - `data` EventResponse[]
    - `id` string, required — The uniqie identifier (UUID) of the Event.
    - `eventName` string, required — The name of the Event as it is registered in the system. This name is used to categorize and trigger associated actions.
    - `eventTime` string, date-time, required — The time when the Event was triggered, using the ISO 8601 date and time format.
    - `m3terEvent` unknown, required
    - `dtActioned` string, date-time, required — When an Event was actioned. It follows the ISO 8601 date and time format. You can action an Event to indicate that it has been followed up and resolved - this is useful when dealing with integration error Events or ingest failure Events.
  - `nextToken` string

## Other responses

- `4XX` — Error message
- `5XX` — Error message

## Changes

- **2025-08-01** `9f9e5f3dbde7` — 1 breaking, 2 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `data` to the response with the `200` status
  - added the optional property `nextToken` to the response with the `200` status
- **2025-02-04** `9433593378b5` — 1 breaking, 2 warning
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `nextToken` from the response with the `200` status

[Change history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/events/get.md)

---

[API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.dev/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)