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

# Get my notification preferences

`GET /api/v1/notifications/preferences`

## Request

- Base URL: `https://app.easyscraper.com`
- URL: `https://app.easyscraper.com/api/v1/notifications/preferences`
- Auth: API key in cookie `better-auth.session_token`

The channels the logged in user can get notifications on (`channels`, in the preferences page's order, with their labels in the request's language): `in-app` when the app has a notification center, `email`, and those a client adds (e.g. push notifications, once they have a device to send them to). Then, for each category of notifications this app sends, whether they get it on each channel that delivers it (`channels`, by ID; categories they haven't changed have the channel's defaults), and the channels that always deliver it (`alwaysOn`: security notifications are always emailed)

## Response `200`

OK

- object
  - `channels` object[], required
    - `id` string, required
    - `label` string, required
  - `preferences` object[], required
    - `category` 'security' | 'membership' | 'team' | 'billing' | 'feedback', required
    - `channels` object, required
    - `alwaysOn` string[], required

## Other responses

- `400`: 400
- `401`: 401
- `429`: 429

## Changes

- **2026-11-02** `a12cef98c52b`: 1 breaking, 1 warning, 4 info
  - removed the required property `preferences/items/email` from the response with the `200` status
  - removed the optional property `preferences/items/inApp` from the response with the `200` status
  - added the non-success response with the status `400`
  - added the required property `channels` to the response with the `200` status
  - …2 more
- **2026-10-31** `3e642e95991a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/easyscraper/apis/easy-scraper-api/changes/api/v1/notifications/preferences/get.md)

---

[API](https://skmtc.dev/easyscraper/apis/easy-scraper-api.md) - [All operations](https://skmtc.dev/easyscraper/apis/easy-scraper-api/llms.txt) - [OpenAPI document](https://skmtc.dev/easyscraper/apis/easy-scraper-api/revisions/a12cef98c52b?raw)