List resource notifications in Dynatrace with the Notification Service API, filtering by app, type, resource, search, ordering, offset, and limit.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/notification/v2/resource-notifications |
You can filter resource notifications with appId, notificationType, resourceId, search, ordering, offset, and limit. The response returns the matching resource notifications for the selected page.
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.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| appId | string | Application id associated with the notification. Optional, by default automatically inferred from the request header. Only relevant for manual testing purposes via swagger. | query | Optional |
| limit | integer | Number of results to return per page. | query | Optional |
| notificationType | string | 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. | query | Optional |
| offset | integer | The initial index from which to return the results. | query | Optional |
| ordering | string | Which field to use when ordering the results. | query | Optional |
| resourceId | string | 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. | query | Optional |
| search | string | A search term. | query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Paginated | - |
| 4XX | Error | - |
| 5XX | Error | - |
PaginatedResourceNotificationList object| Element | Type | Description |
|---|---|---|
| count | integer | - |
| results | Resource | - |
ResourceNotification object| Element | Type | Description |
|---|---|---|
| id | string | - |
| appId | string | App id for registered notification. Optional, by default automatically inferred from the request. Only relevant for manual testing purposes via swagger. |
| notificationType | string | 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. |
| resourceId | string | 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. |
| owningUser | string | - |
| modificationInfo | Modification | - |
ModificationInfo object| Element | Type | Description |
|---|---|---|
| createdBy | string | - |
| createdTime | string | - |
| lastModifiedBy | string | - |
| lastModifiedTime | string | - |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| message | string | - |
| code | integer | - |
| details | Error | - |
ErrorDetails object| Element | Type | Description |
|---|---|---|
| errorCode | string | - |
| errorRef | string | - |
{"count": 123,"results": [{"id": "string","appId": "string","notificationType": "string","resourceId": "string","owningUser": "string","modificationInfo": {"createdBy": "string","createdTime": "string","lastModifiedBy": "string","lastModifiedTime": "string"}}]}
{"error": {"message": "string","code": 1,"details": {"errorCode": "string","errorRef": "string"}}}