Try it free

Get an event notification

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

Get an event notification in Dynatrace with the Notification Service API by ID, and retrieve its details for the specified self notification.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/notification/v2/event-notifications/{id}

Overview

You provide the id path parameter to identify the self notification you want to retrieve. Dynatrace returns the event notification in the 200 response.

Authentication

To execute this request, you need a platform token or OAuth access token with notification:notifications:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
idstring

A UUID string identifying this self notification.

pathRequired

Response

Response codes

CodeTypeDescription
200EventNotification-
4XXErrorEnvelope-
5XXErrorEnvelope-

Response body objects

The EventNotification object

ElementTypeDescription
idstring-
titlestring-
resourceIdstring

Unique identifier of resource to notify on. Used to determine if there is a notification registered for a resource in context of the app and notification type for a user.

notificationTypestring

String that defines the type of a notification in context of an app. Allows to differentiate between multiple types of notifications in context of one app.

triggerConfigurationEventQueryTriggerConfig | DavisProblemTriggerConfig | DavisEventTriggerConfig-
modificationInfoModificationInfo-
inputEventNotificationInput

Input object consisting of subject and content. Supports automation expressions https://dt-url.net/workflows-expression-reference and markdown syntax. A template provided with an app ({notification_type}.notification-template.json) will take precedence over the input provided here.

appIdstring

App id for registered notification. Optional, by default automatically inferred from the request. Only relevant for manual testing purposes via swagger.

ownerstring-

The EventTriggerConfig object

The EventQueryTriggerConfig object

Config for generic event triggers ("Event trigger"). No dedup — fires on every matching event.

ElementTypeDescription
typeEventQueryTriggerConfigType-
The element can hold these values
  • event
valueEventQuery-

The DavisProblemTriggerConfig object

Config for Problem event triggers ("Problem trigger").

Deduplicated across a problem's lifecycle: fires once per phase selected by the trigger config (triggerOn, triggerOnUpdateFields), not on every update.

ElementTypeDescription
typeDavisProblemTriggerConfigType-
The element can hold these values
  • davis-problem
valueDavisProblemConfig-

The DavisEventTriggerConfig object

Config for Davis Event event triggers ("Davis event trigger").

Deduplicated across an event's lifecycle: fires once per phase selected by the trigger config (triggerOn), not on every update.

ElementTypeDescription
typeDavisEventTriggerConfigType-
The element can hold these values
  • davis-event
valueDavisEventConfig-

The EventQueryTriggerConfigType object

The EventQuery object

ElementTypeDescription
querystring

DQL matcher expression defining which events to match.

eventTypeEventType

Grail event type.

The element can hold these values
  • events
  • bizevents
  • dt.system.events
  • security.events

The EventType object

Grail event type.

The DavisProblemTriggerConfigType object

The DavisProblemConfig object

ElementTypeDescription
entityTagsMatchEntityTagsMatch-
entityTagsEntityTags-
onProblemCloseboolean

DEPRECATED

Trigger on Davis problem open only or also on close. Deprecated — use triggerOn instead.

triggerOnTriggerOn

Problem state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility.

categoriesDavisProblemCategories-
customFilterstring

Additional DQL matcher expression to further filter events to match.

analysisReadyboolean

Run only after first root cause analysis run completed.

severityThresholdinteger

Triggers only for problems whose severity is this value or more severe. Lower numbers are more severe (1 = critical, 5 = informational), so 3 matches severities 1, 2, and 3.

triggerOnUpdateFieldsTriggerOnUpdateFields[]

Problem event fields tracked for value changes. Changes to any selected field cause re-triggering.

problemOpenDurationinteger

Minimum problem duration in minutes before the trigger fires.

The element can hold these values
  • 5
  • 10
  • 15
  • 30
  • 60
  • 120
  • 240
  • 1440
  • 10080

The EntityTagsMatch object

Event must match all or any of the entity tags.

The EntityTags object

Entity tags to match by key and (optional) values. For example {"foo": [], "bar": ["a", "b", "c"]}

The TriggerOn object

The DavisProblemCategories object

ElementTypeDescription
monitoringUnavailableboolean-
availabilityboolean-
errorboolean-
slowdownboolean-
resourceboolean-
customboolean-
infoboolean-

The TriggerOnUpdateFields object

The DavisEventTriggerConfigType object

The DavisEventConfig object

ElementTypeDescription
entityTagsMatchEntityTagsMatch-
entityTagsEntityTags-
onProblemCloseboolean

DEPRECATED

Trigger on Davis event open only or also on close. Deprecated — use triggerOn instead.

triggerOnTriggerOn

Event state to trigger on. "open" (active only), "open-and-close" (both phases), or "close" (closure only). When unset, falls back to onProblemClose for backward compatibility.

namesDavisEventName[]-
typesstring[]

DEPRECATED

-
customFilterstring

Additional DQL matcher expression to further filter events to match.

maintenanceWindowTriggerBehaviorMaintenanceWindowTriggerBehaviorType-

The DavisEventName object

ElementTypeDescription
matchDavisEventNameMatch

Davis event name must equal or contain the string provided.

The element can hold these values
  • equals
  • contains
namestring-

The DavisEventNameMatch object

Davis event name must equal or contain the string provided.

The MaintenanceWindowTriggerBehaviorType object

Specifies when to trigger based on maintenance window status.

The ModificationInfo object

ElementTypeDescription
createdBystring-
createdTimestring-
lastModifiedBystring-
lastModifiedTimestring-

The EventNotificationInput object

ElementTypeDescription
subjectstring-
contentstring-

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
  "id": "string",
  "title": "string",
  "resourceId": "string",
  "notificationType": "string",
  "triggerConfiguration": {
    "type": "event",
    "value": {
      "eventType": "bizevents",
      "query": "event.kind == \"CUSTOM_KIND\""
    }
  },
  "modificationInfo": {
    "createdBy": "string",
    "createdTime": "string",
    "lastModifiedBy": "string",
    "lastModifiedTime": "string"
  },
  "input": {
    "subject": "string",
    "content": "string"
  },
  "appId": "string",
  "owner": "string"
}
{
  "error": {
    "message": "string",
    "code": 1,
    "details": {
      "errorCode": "string",
      "errorRef": "string"
    }
  }
}
Related tags
Platform APIDynatrace Platform