---
title: "List notifications with pagination, optionally in one category"
method: GET
path: "/dashboard/notifications"
tags: ["Notifications"]
---

# List notifications with pagination, optionally in one category

`GET /dashboard/notifications`

## Request

- Base URL: `https://blockreq.com/api`
- URL: `https://blockreq.com/api/dashboard/notifications`
- Auth: HTTP bearer

## Query parameters

- `page` integer
- `limit` integer
- `category` 'billing' | 'security' | 'tickets' | 'team' | 'announcement'
- `language` 'en' | 'zh'

## Response `200`

Notifications

- object
  - `code` number, required
  - `ok` boolean, required
  - `data` object, required
    - `items` object[], required
      - `id` number, required
      - `type` string, required
      - `category` 'billing' | 'security' | 'tickets' | 'team' | 'announcement', required
      - `title` string, required
      - `message` string, required
      - `link` string, nullable, required
      - `read` boolean, required
      - `createdAt` string, required
    - `unreadCount` number, required
    - `unreadByCategory` object, required
      - `billing` number, required
      - `security` number, required
      - `tickets` number, required
      - `team` number, required
      - `announcement` number, required
    - `pagination` object, required
      - `total` number, required
      - `page` number, required
      - `limit` number, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Error

---

[API](https://skmtc.dev/blockreq/apis/blockreq-public-api.md) · [All operations](https://skmtc.dev/blockreq/apis/blockreq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blockreq/apis/blockreq-public-api/revisions/f433235ab9af?raw)