Skip to main content

List notification subscriptions

GET

Returns the current notification configuration and all notification subscriptions for the caller's environment.

Response

  • 200 OK
FieldTypeDescription
configurationobject or nullEnvironment-level notification signing and token configuration
configuration.xNotificationTokenstringToken used in outbound notification headers
configuration.rsaKeyobjectPublic-key details used to verify signed requests
configuration.rsaKey.publicstringPublic RSA key in PEM format
subscriptionsarrayNotification subscriptions for the current environment
subscriptions[].idstringSubscription identifier
subscriptions[].namestringSubscription display name
subscriptions[].urlstringDelivery URL
subscriptions[].statusstringCurrent status: active or paused
subscriptions[].filterobjectStored JSON Logic filter
subscriptions[].consecutiveFailureCountintegerNumber of consecutive delivery failures
subscriptions[].pausedAtdatetime or nullTimestamp when the subscription was paused
subscriptions[].statusReasonstring or nullPause reason, for example manual or circuit_breaker
subscriptions[].createdAtdatetimeCreation timestamp
subscriptions[].updatedAtdatetimeLast update timestamp

Example

{
"configuration": {
"xNotificationToken": "0123456789abcdef0123456789abcdef",
"rsaKey": {
"public": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBg...\n-----END PUBLIC KEY-----"
}
},
"subscriptions": [
{
"id": "65f3b1d8e83b5d0a4af00c91",
"name": "High impact alerts",
"url": "https://example.com/notify",
"status": "active",
"filter": {
">=": [
{
"var": "computed.impact.max_24h"
},
3
]
},
"consecutiveFailureCount": 0,
"pausedAt": null,
"statusReason": null,
"createdAt": "2026-03-20T10:15:00.000Z",
"updatedAt": "2026-03-20T10:15:00.000Z"
}
]
}