---
title: "List all notifications"
method: GET
path: "/notification"
tags: ["notification"]
---

# List all notifications

`GET /notification`

## Response `200`

Get all your workspace notification

- Notification[]
  - `id` number, required — The id of the notification
  - `name` string, required — The name of the notification
  - `provider` 'discord' | 'email' | 'google-chat' | 'grafana-oncall' | 'ms-teams' | 'ntfy' | 'pagerduty' | 'opsgenie' | 'slack' | 'sms' | 'telegram' | 'webhook' | 'whatsapp', required — The provider of the notification
  - `payload` union, required — The data of the notification
    - object
      - `discord` string, uri, required
    - object
      - `email` string, email, required
    - object
      - `grafana-oncall` object, required
        - `webhookUrl` string, uri, required
    - object
      - `ms-teams` object, required
        - `webhookUrl` string, uri, required
    - object
      - `ntfy` object, required
        - `topic` string
        - `serverUrl` string
        - `token` string
    - object
      - `opsgenie` object, required
        - `apiKey` string, required
        - `region` 'us' | 'eu', required
    - object
      - `pagerduty` string, required
    - object
      - `sms` string, required
    - object
      - `telegram` object, required
        - `chatId` string, required
    - object
      - `slack` string, uri, required
    - object
      - `webhook` object, required
        - `endpoint` string, uri, required
        - `headers` object[]
          - `key` string, required
          - `value` string, required
    - object
      - `whatsapp` string, required
    - object
      - `google-chat` string, uri, required
  - `monitors` number[], nullable — The monitors that the notification is linked to

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing).
- `401` — The client must authenticate itself to get the requested response.
- `402` — A higher pricing plan is required to access the resource.
- `403` — The client does not have the necessary permissions to access the resource.
- `404` — The server can't find the requested resource.
- `409` — The request could not be completed due to a conflict mainly due to unique constraints.
- `500` — The server has encountered a situation it doesn't know how to handle.

---

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