---
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

---

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