# List active notifications.

`GET /notifications`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-notifications · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetNotifications` · Tag: Notifications

Returns all active (non-dismissed, non-expired) notifications for the authenticated user, ordered most-recent first. These are the same notifications displayed in the Wheelhouse dashboard at `/u/account/notifications`.

`review_url` is a relative Wheelhouse dashboard URL that links to the relevant feature page for each notification (e.g. the market report, listing calendar, or dynamic set it relates to).

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/notifications`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/notifications' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Array of active notifications.

Body (`application/json`): array of object `notification_response`

An in-app notification.

- `id` (integer): The Wheelhouse internal notification ID. Use this when dismissing specific notifications.
- `title` (string, nullable): Short title of the notification.
- `body_text` (string, nullable): Body text of the notification.
- `category` (string, nullable): Category of the notification.
- `reference_type` (string, nullable): The type of entity this notification relates to (e.g. `MarketReport`, `CompSetV2`, `PricePostingError`).
- `reference_id` (integer, nullable): The ID of the referenced entity.
- `expires_at` (string (date-time), nullable): When the notification expires and will no longer be returned (ISO-8601).
- `created_at` (string (date-time)): When the notification was created (ISO-8601).
- `review_url` (string, nullable): Relative Wheelhouse dashboard URL for the feature related to this notification (e.g. `/markets/v1/123/overview`). Falls back to `/u/account/notifications` when no specific page applies.

Example shape (generated from the schema; placeholder values, not a real response):

```json
[
  {
    "id": 0,
    "title": "string",
    "body_text": "string",
    "category": "string",
    "reference_type": "string",
    "reference_id": 0,
    "expires_at": "2026-01-01T00:00:00Z",
    "created_at": "2026-01-01T00:00:00Z",
    "review_url": "string"
  }
]
```

### 401

API key authorization failed.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
