---
title: "Get the authenticated user's notification preferences"
method: GET
path: "/v2/settings/users/{userId}/notification-preferences"
tags: ["Notification Preferences Api Service"]
---

# Get the authenticated user's notification preferences

`GET /v2/settings/users/{userId}/notification-preferences`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/users/{userId}/notification-preferences`
- Auth: none declared

## Path parameters

- `userId` integer, required

## Response `200`

Resolved notification preferences matrix

- JsonOkResponseNotificationPreferencesDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` NotificationPreferencesDto: Full resolved notification preferences matrix for the authenticated user
    - `events` NotificationEventPreferenceDto[]: Resolved matrix, one entry per event
      - `event` string: Event id
      - `channels` NotificationChannelPreferenceDto[]: Effective state per channel
        - `channel` string: Channel id
        - `enabled` boolean: Effective enabled state after applying the per-cell override, the global email opt-out and the event default
    - `emailGloballyOff` boolean: Global email opt-out flag; when true, every EMAIL channel is effectively disabled

## Other responses

- `403`: Delegated proxy sessions (integrator/alias/Vendasta) cannot manage preferences

---

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