---
title: "Get a list of notifications for your organization."
method: GET
path: "/notifications"
tags: ["notifications"]
---

# Get a list of notifications for your organization.

`GET /notifications`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/notifications`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/notifications/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of notifications ordered by their ID. By default, only notifications from the
last 7 days are returned.

Required API key permissions: `Admin` (select when creating API key in Account Settings)

## Response `200`

List of notifications

- GetNotificationsV1ResponsePayloadBody
  - `next_page_token` string: The token to be used to retrieve the next page of results. The field will be missing if there are no results.
  - `notifications` Notification[]: The list of notifications.
    - `context` object: The context metadata for the notification.
    - `description` string: Description for the notification.
    - `notification_id` string: The ID of the notification.
    - `occurred_at` string, date-time: The time the notification was fired.
    - `type` string: The type of the notification.

## Other responses

- `422`: An invalid parameter was supplied or a mandatory parameter was missing
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)