# List your Notifications

> Lists the user's Notifications, newest first.

`GET /notifications` on `https://api.mediux.io`

Each Notification has its `kind`, the `actor` who caused it (or `null`), the `subject` it is about as `{kind, id}` (or `null`) and `readAt` (`null` while unread). Pages default to 50 and hold at most 100. Pass `meta.nextCursor` as `after` to continue.

## Authorization

OAuth 2 bearer token in the `Authorization` header. Required permission: `notifications:read`.

## Parameters

- `after` (query, string): The `meta.nextCursor` from the previous page.
- `limit` (query, string): Page size, 1 to 100. Defaults to 50.

## Responses

### 200

A page of Notifications.

- `data` (array of object, required)
  - `id` (string (uuid), required)
  - `kind` (string, required): One of "followed", "setUpdated", "request", "assetIssue", "moderation", "announcement", "other".
  - `createdAt` (string, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
  - `readAt` (string, nullable, required): ISO 8601 UTC instant with milliseconds, such as `2026-11-14T15:03:02.000Z`.
  - `actor` (object, nullable, required)
    - `id` (string (uuid), required)
    - `username` (string, required)
    - `avatar` (object, nullable, required)
      - `id` (string (uuid), required): Stable image ID, a lowercase UUID. Variant filenames use the same ID.
      - `extension` (string, required): Extension of the Original, such as `png`.
  - `subject` (object, nullable, required)
    - `kind` (string, required): One of "user", "asset", "boxset", "loadout", "showSet", "movieSet", "collectionSet", "gameSet", "show", "season", "episode", "movie", "collection", "game", "person", "network", "company", "category", "other".
    - `id` (integer | string (uuid), required)
- `meta` (object, required)
  - `limit` (integer, required)
  - `nextCursor` (string, nullable, required)

### 400

The request is malformed or failed validation. Inspect `error.code` and `error.issues`.

### 401

The access token is missing (`auth.required`), or invalid, expired or revoked (`auth.invalidToken`).

### 403

The token lacks the required App Permission (`auth.insufficientScope`, with `details.required`), or the account or connection may not do this (`auth.forbidden`).

### 429

Too many requests. Wait the `Retry-After` seconds before trying again.

### 503

Temporarily unavailable. Check the outcome before retrying a write.

## Example response (200)

```json
{
  "data": [],
  "meta": {
    "limit": 50,
    "nextCursor": null
  }
}
```
