---
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
  - `page` Configv1PageResult
    - `next_token` string — Opaque page token which identifies the next page of items which the client should request. An empty next_token indicates that there are no more items to return.
  - `notification_policies` Configv1NotificationPolicy[]
    - `slug` string — Unique identifier of the NotificationPolicy. If a `slug` isn't provided, one will be generated based of the `name` field. You can't modify this field after the NotificationPolicy is created.
    - `name` string — Required. Name of the NotificationPolicy. You can modify this value after the NotificationPolicy is created.
    - `created_at` string, date-time — Timestamp of when the NotificationPolicy was created. Cannot be set by clients.
    - `updated_at` string, date-time — Timestamp of when the NotificationPolicy was last updated. Cannot be set by clients.
    - `bucket_slug` string — Slug of the bucket the notification policy belongs to. Required if team_slug is not set.
    - `team_slug` string — Slug of the team the notification policy belongs to. Required if bucket_slug is not set.
    - `routes` NotificationPolicyRoutes
      - `defaults` RoutesSeverityNotifiers
        - `warn` RoutesNotifierList
          - `notifier_slugs` string[] — Slugs of notifiers that will receive the alerts.
          - `repeat_interval_secs` integer — Frequency at which to resend alerts.
          - `group_by` NotificationPolicyRoutesGroupBy
            - `label_names` string[] — Set of label names used to group alerts. For example, if label_names is ["service", "code"] then all alerts including labels {service="foo",code="404"} will be grouped together.
        - `critical` RoutesNotifierList
          - `notifier_slugs` string[] — Slugs of notifiers that will receive the alerts.
          - `repeat_interval_secs` integer — Frequency at which to resend alerts.
          - `group_by` NotificationPolicyRoutesGroupBy
            - `label_names` string[] — Set of label names used to group alerts. For example, if label_names is ["service", "code"] then all alerts including labels {service="foo",code="404"} will be grouped together.
      - `overrides` NotificationPolicyRoutesOverride[] — Optional list of overrides to use for alerts having matching labels. Each override defines labels that potentially match an alert's labels. If one or more overrides match an alert, the notifiers of the first matching override are used instead of the defaults.
        - `alert_label_matchers` Configv1LabelMatcher[] — Set of matchers on an alert's labels. If all labels match then the override notifiers apply.
          - `type` 'EXACT' | 'REGEX'
          - `name` string — name always matches against an exact label name.
          - `value` string — value matches against a label value based on the configured type.
        - `notifiers` RoutesSeverityNotifiers
          - `warn` RoutesNotifierList
            - `notifier_slugs` string[] — Slugs of notifiers that will receive the alerts.
            - `repeat_interval_secs` integer — Frequency at which to resend alerts.
            - `group_by` NotificationPolicyRoutesGroupBy
              - …
          - `critical` RoutesNotifierList
            - `notifier_slugs` string[] — Slugs of notifiers that will receive the alerts.
            - `repeat_interval_secs` integer — Frequency at which to resend alerts.
            - `group_by` NotificationPolicyRoutesGroupBy
              - …

## Other responses

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

---

[API](https://skmtc.net/chronosphere/apis/config-v1-api.md) · [All operations](https://skmtc.net/chronosphere/apis/config-v1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chronosphere/config-v1-api/revisions/530951bd2ccf/schema)