Notifications API - POST filter notifications

  • Latest Dynatrace
  • Reference
  • Published Feb 24, 2026

This API returns all account‑level notification types, including budget, cost, forecast, and BYOK notifications.

Parameters

ParameterTypeDescriptionInRequired
accountUuidstring

The ID of the required account.

You can find the UUID on the Account Management > Identity & access management > OAuth clients page, during creation of an OAuth client.

pathRequired
bodyNotificationQueryParamsDto-bodyRequired

Request body objects

The NotificationQueryParamsDto object

ElementTypeDescriptionRequired
startDateTimestring

Start date and time to filter notifications.

Optional
endDateTimestring

End date and time to filter notifications.

Optional
typesstring[]

Notification types to filter notifications.

The element can hold these values
  • FORECAST
  • BUDGET
  • COST
  • BYOK_REVOKED
  • BYOK_ACTIVATED
Optional
severitiesstring[]

Notification severities to filter notifications.

The element can hold these values
  • SEVERE
  • WARN
  • INFO
Optional
capabilitiesarray[]

Capabilities to filter notifications.

Optional
environmentsarray[]

Environments to filter notifications.

Optional
pagenumber

The page number.

Optional
pageSizenumber

The maximum number of notifications to return, max 100.

Optional
sortsstring[]

The property to sort by. Prefix with "-" to invert sort order.

The element can hold these values
  • type
  • -type
  • date
  • -date
Optional

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

{
  "startDateTime": "2023-01-01T00:00:00Z",
  "endDateTime": "2023-12-31T23:59:59Z",
  "types": [
    "FORECAST"
  ],
  "severities": [
    "SEVERE"
  ],
  "capabilities": [
    "LOG_MANAGEMENT_ANALYZE"
  ],
  "environments": [
    "abc12345"
  ],
  "page": 1,
  "pageSize": 20,
  "sorts": [
    "-date"
  ]
}

Response

Response codes

CodeTypeDescription
200NotificationListDto

Success. The response contains a list of notifications based on the given query.

400-

Failed. The request was unacceptable, often due to missing a required parameter

401-

Failed. The bearer token is incorrect/expired or the requested account information does not match the bearer token

403-

Access denied

404-

Failed. The requested resource was not found

500-

Failed. Something went wrong in Account Management API

Response body objects

The NotificationListDto object

ElementTypeDescription
recordsNotificationDto[]

A list of notifications of the account.

totalRecordCountnumber

The total number of notifications matching the filter.

hasNextPageboolean

If there are more notifications.

The NotificationDto object

ElementTypeDescription
keystring-
accountUuidstring-
messagestring-
severitystring-
typestring-
detailsSubscriptionRelatedEventDataDto-
datestring-

The SubscriptionRelatedEventDataDto object

ElementTypeDescription
environmentsstring[]-
capabilitiesstring[]-
allEnvironmentsboolean-
allCapabilitiesboolean-

Response body JSON models

{
  "records": [
    {
      "key": "budget-key-example",
      "accountUuid": "00000000-0000-0000-0000-000000000000",
      "message": "Message for budget 0 0",
      "severity": "WARN",
      "type": "budget",
      "details": {
        "environments": [
          {
            "uuid": "env-uuid",
            "clusterUuid": "cluster-uuid"
          }
        ],
        "capabilities": [
          "cap1"
        ],
        "allEnvironments": false,
        "allCapabilities": true
      },
      "date": "2025-12-14T10:02:09.297Z"
    },
    {
      "key": "byok-key-example",
      "accountUuid": "00000000-0000-0000-0000-000000000000",
      "message": "BYOK event message",
      "severity": "WARN",
      "type": "byok-revoked",
      "details": {
        "environmentUuid": "env-uuid",
        "keyName": "key-name"
      },
      "date": "2025-12-14T10:02:09.297Z"
    }
  ],
  "totalRecordCount": 300,
  "hasNextPage": true
}