---
title: "GET /v1/notification-groups/{notificationGroupUid}/subscription"
method: GET
path: "/v1/notification-groups/{notificationGroupUid}/subscription"
tags: ["NotificationGroupSubscription"]
---

# GET /v1/notification-groups/{notificationGroupUid}/subscription

`GET /v1/notification-groups/{notificationGroupUid}/subscription`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `notificationGroupUid` string, required

## Response `200`

OK

- MarksmanApiV1GetNotificationGroupSubscriptionReply
  - `filter` MarksmanApiV1SubscriptionFilter: Subscription filter: when multiple dimensions are set, an alert matches if it satisfies at least one (OR). - strategyGroupUids: alert's strategy must belong to one of these groups. - strategyUids: alert's strategy_uid must be in this list. - strategyLevels: alert's (strategy_uid, level_uid) must be in this list. - labels: alert must contain all these key-value pairs with the same values. - excludeLabels: alert must not contain any of these key-value pairs (subset match). - datasourceUids: alert's datasource must be in this list. - datasourceLevelUids: alert datasource's level_uid must be in this list.
    - `strategyGroupUids` string[]
    - `strategyUids` string[]
    - `strategyLevels` MarksmanApiV1StrategyLevelPair[]
      - `strategyUid` string
      - `levelUid` string
    - `datasourceUids` string[]
    - `labels` object
    - `excludeLabels` object
    - `datasourceLevelUids` string[]

## Changes

- **2026-03-26** `4da54e2814a0`: 1 info
  - added the optional property `filter/datasourceLevelUids` to the response with the `200` status
- **2026-03-20** `20ac59a18d7e`: 2 info
  - added the optional property `filter/datasourceUids` to the response with the `200` status
  - added the optional property `filter/excludeLabels` to the response with the `200` status
- **2026-03-19** `b5204058c429`: 1 info
  - endpoint added
- **2026-02-28** `f5912329bb01`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/changes/v1/notification-groups/:notificationGroupUid/subscription/get.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-marksman-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-marksman-api/revisions/26ae221fccba?raw)