---
title: "List notifications."
method: GET
path: "/v2/console/notification"
tags: ["Console"]
---

# List notifications.

`GET /v2/console/notification`

## Request

- Base URL: `http://127.0.0.1:7351`
- URL: `http://127.0.0.1:7351/v2/console/notification`
- Auth: API key in header `Authorization`

## Query parameters

- `user_id` string
- `limit` integer
- `cursor` string

## Response `200`

A successful response.

- ConsoleNotificationList
  - `notifications` ConsoleNotification[]: List of notifications.
    - `id` string: ID of the Notification.
    - `subject` string: Subject of the notification.
    - `content` string: Content of the notification in JSON.
    - `code` integer: Category code for this notification.
    - `sender_id` string: ID of the sender, if a user. Otherwise 'null'.
    - `create_time` string, date-time: The UNIX time (for gRPC clients) or ISO string (for REST clients) when the notification was created.
    - `persistent` boolean: True if this notification was persisted to the database.
    - `user_id` string: User id.
  - `next_cursor` string: Next page cursor if any.
  - `prev_cursor` string: Previous page cursor if any.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/heroiclabs/apis/nakama-console-api-v2.md) - [All operations](https://skmtc.dev/heroiclabs/apis/nakama-console-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/heroiclabs/apis/nakama-console-api-v2/revisions/fbde2e3c5ead?raw)