---
title: "GET /api/v1/config/notification-policies"
method: GET
path: "/api/v1/config/notification-policies"
tags: ["NotificationPolicy"]
---

# GET /api/v1/config/notification-policies

`GET /api/v1/config/notification-policies`

## Query parameters

- `page.max_size` integer
- `page.token` string
- `slugs` string[]
- `names` string[]
- `bucket_slugs` string[]
- `team_slugs` string[]

## Response `200`

A successful response.

- Configv1ListNotificationPoliciesResponse
  - `notification_policies` Configv1NotificationPolicy[]
    - `bucket_slug` string — The slug of the bucket that the notification policy belongs to. Required if `team_slug` is not set.
    - `created_at` string, date-time — Timestamp of when the NotificationPolicy was created. Cannot be set by clients.
    - `name` string, required — The name of the NotificationPolicy. You can modify this value after the NotificationPolicy is created.
    - `routes` NotificationPolicyRoutes
      - `defaults` RoutesSeverityNotifiers, required
        - `critical` RoutesNotifierList
          - `destinations` RoutesDestination[] — Notification destinations. Cannot be set if notifier_slugs is set.
            - `disable_resolves` boolean — If true, do not send notifications when alerts resolve. Defaults to false (resolve notifications are sent).
            - `email` DestinationEmailTarget
              - …
            - `ops_genie` DestinationOpsGenieTarget
              - …
            - `pagerduty` DestinationPagerdutyTarget
              - …
            - `slack` DestinationSlackTarget
              - …
            - `victor_ops` DestinationVictorOpsTarget
              - …
            - `webhook` DestinationWebhookTarget
              - …
          - `disable_repeat` boolean — If true, alerts are notified once and on state changes (new firing alerts, resolves) but are never re-sent on the repeat_interval timer. Defaults to false (alerts repeat on repeat_interval_secs).
          - `notifier_slugs` string[] — The slugs of the notifiers that will receive the alerts.
          - `repeat_interval_secs` integer — The frequency at which to resend alerts. Ignored when disable_repeat is true.
        - `warn` RoutesNotifierList
          - `destinations` RoutesDestination[] — Notification destinations. Cannot be set if notifier_slugs is set.
            - `disable_resolves` boolean — If true, do not send notifications when alerts resolve. Defaults to false (resolve notifications are sent).
            - `email` DestinationEmailTarget
              - …
            - `ops_genie` DestinationOpsGenieTarget
              - …
            - `pagerduty` DestinationPagerdutyTarget
              - …
            - `slack` DestinationSlackTarget
              - …
            - `victor_ops` DestinationVictorOpsTarget
              - …
            - `webhook` DestinationWebhookTarget
              - …
          - `disable_repeat` boolean — If true, alerts are notified once and on state changes (new firing alerts, resolves) but are never re-sent on the repeat_interval timer. Defaults to false (alerts repeat on repeat_interval_secs).
          - `notifier_slugs` string[] — The slugs of the notifiers that will receive the alerts.
          - `repeat_interval_secs` integer — The frequency at which to resend alerts. Ignored when disable_repeat is true.
      - `overrides` NotificationPolicyRoutesOverride[] — A list of overrides to use for alert notification policies. Each override defines the labels that potentially match an alert. If an alert has matching labels, the override notification policy is used for that alert instead of the default notification policy. If multiple overrides match the same alert, the first matching override notification policy is used.
        - `alert_label_matchers` Configv1LabelMatcher[] — The alert labels to match against. If an alert matches all of these labels, the override notifier is applied to that alert.
          - `name` string — The name of the label to match against. This always matches against an exact label name, regardless of the value of `type`.
          - `type` 'EXACT' | 'REGEX'
          - `value` string — The value of the label to match against. If `type` is set to `EXACT`, this matches against an exact label value. If `type` is set to `REGEX`, this parameter is treated as a regular expression for parsing label values.
        - `notifiers` RoutesSeverityNotifiers
          - `critical` RoutesNotifierList
            - `destinations` RoutesDestination[] — Notification destinations. Cannot be set if notifier_slugs is set.
              - …
            - `disable_repeat` boolean — If true, alerts are notified once and on state changes (new firing alerts, resolves) but are never re-sent on the repeat_interval timer. Defaults to false (alerts repeat on repeat_interval_secs).
            - `notifier_slugs` string[] — The slugs of the notifiers that will receive the alerts.
            - `repeat_interval_secs` integer — The frequency at which to resend alerts. Ignored when disable_repeat is true.
          - `warn` RoutesNotifierList
            - `destinations` RoutesDestination[] — Notification destinations. Cannot be set if notifier_slugs is set.
              - …
            - `disable_repeat` boolean — If true, alerts are notified once and on state changes (new firing alerts, resolves) but are never re-sent on the repeat_interval timer. Defaults to false (alerts repeat on repeat_interval_secs).
            - `notifier_slugs` string[] — The slugs of the notifiers that will receive the alerts.
            - `repeat_interval_secs` integer — The frequency at which to resend alerts. Ignored when disable_repeat is true.
    - `slug` string — The unique identifier of the NotificationPolicy. If a `slug` isn't provided, one is generated based on the `name` field. You can't modify this field after the NotificationPolicy is created.
    - `team_slug` string — The slug of the team that the notification policy belongs to. Required if `bucket_slug` is not set.
    - `updated_at` string, date-time — Timestamp of when the NotificationPolicy was last updated. Cannot be set by clients.
  - `page` Configv1PageResult
    - `next_token` string — An opaque page token that identifies the next page of items that the client should request. An empty value indicates that there are no more items to return.

## Other responses

- `500` — An unexpected error response.
- `default` — An undefined error response.

---

[API](https://skmtc.dev/chronosphere/apis/data-v1-api.md) · [All operations](https://skmtc.dev/chronosphere/apis/data-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chronosphere/data-v1-api/revisions/ee91fd539ced/schema)