Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1439228184.1 KB

Returns a list of NotificationEvents according to specified filters, in reverse chronological order (newest first).

User Notifications stores notifications in the individual Regions you register as notification hubs and the Region of the source event rule. ListNotificationEvents only returns notifications stored in the same Region in which the action is called. User Notifications doesn't backfill notifications to new Regions selected as notification hubs. For this reason, we recommend that you make calls in your oldest registered notification hub. For more information, see Notification hubs in the Amazon Web Services User Notifications User Guide.

get/notification-events

Query parameters

startTimestring date-time

The earliest time of events to return from this call.

endTimestring date-time

Latest time of events to return from this call.

locale'de_DE' | 'en_CA' | 'en_US' | 'en_UK' | 'es_ES' | 'fr_CA' | 'fr_FR' | 'id_ID' | 'it_IT' | 'ja_JP' | 'ko_KR' | 'pt_BR' | 'tr_TR' | 'zh_CN' | 'zh_TW'

The locale code of the language used for the retrieved <code>NotificationEvent</code>. The default locale is English <code>(en_US)</code>.

sourcestring
<p>The matched event source.</p> <p>Must match one of the valid EventBridge sources. Only Amazon Web Services service sourced events are supported. For example, <code>aws.ec2</code> and <code>aws.cloudwatch</code>. For more information, see <a href="https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level">Event delivery from Amazon Web Services services</a> in the <i>Amazon EventBridge User Guide</i>.</p>
includeChildEventsboolean

Include aggregated child events in the result.

aggregateNotificationEventArnstring

The Amazon Resource Name (ARN) of the <code>aggregatedNotificationEventArn</code> to match.

maxResultsinteger

The maximum number of results to be returned in this call. Defaults to 20.

nextTokenstring

The start token for paginated calls. Retrieved from the response of a previous <code>ListEventRules</code> call. Next token uses Base64 encoding.

organizationalUnitIdstring

The unique identifier of the organizational unit used to filter notification events.

Response

Success

nextTokenstring

A pagination token. If a non-null pagination token is returned in a result, pass its value in another request to retrieve more entries.