---
title: "List by org"
method: GET
path: "/notifications/groups/list_by_org/v1"
tags: ["/notifications", "/groups"]
---

# List by org

`GET /notifications/groups/list_by_org/v1`

Lists all notification groups for the caller's organization. | authz: min_org_role=operator | () -> (NotificationGroupListRes)

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- NotificationGroupListRes
  - `items` NotificationGroup1[], required
    - `schema_version` 1, required
    - `group_name` string, required
    - `org_id` string, required — Must be a string starting with `org_`
    - `created_at_timestamp` string, date-time, required
    - `last_edited_at_timestamp` string, date-time, required
    - `user_ids` string[]
    - `user_ids_opted_out` string[]
    - `email_events` NotificationEventsForOrgsEnum[]
    - `push_events` NotificationEventsForOrgsEnum[]
    - `sms_events` NotificationEventsForOrgsEnum[]
    - `_id` string, required
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)