---
title: "Get notification preferences"
method: GET
path: "/api/notifications/preferences"
tags: ["Notifications"]
---

# Get notification preferences

`GET /api/notifications/preferences`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/notifications/preferences`
- Auth: HTTP bearer

Returns the user's notification preferences for each category and channel (in_app, email). Missing preferences default to enabled.

Requires `notifications:read` scope.

## Response `200`

Notification preferences

- object
  - `preferences` object[]
    - `category` 'domains' | 'transfers' | 'marketplace' | 'email' | 'inquiries': Preference category
    - `label` string
    - `description` string
    - `channel` 'in_app' | 'email'
    - `enabled` boolean
  - `expiry_alert_days` integer[]: Days-before-expiry the user receives renewal reminders (default 30/7/1). Empty = no expiry reminders.

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)