> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get notification preferences

> Read the authenticated user's notification opt-ins

`GET /api/v2/notification-preferences`

Returns the notification opt-ins for the authenticated user. Each opt-in pairs a `notificationType` with a delivery `channel`.

## Request

```bash curl theme={null}
curl https://api.interchange.io/api/v2/notification-preferences \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

None. Preferences are scoped to the authenticated user.

## Response

```json theme={null}
{
  "optIns": [
    { "notificationType": "media_buy.created", "channel": "email" },
    { "notificationType": "creative.rejected", "channel": "in_app" }
  ]
}
```

| Field                       | Type   | Notes                                                                            |
| --------------------------- | ------ | -------------------------------------------------------------------------------- |
| `optIns[]`                  | array  | One entry per enabled notification                                               |
| `optIns[].notificationType` | string | The event the user is opted into (e.g. `media_buy.created`, `creative.rejected`) |
| `optIns[].channel`          | enum   | `email` or `in_app`                                                              |

Always-on operational types (for example `source.action_required` and `source.action_resolved`) do not appear in `optIns` — they are delivered in-app and by email regardless of opt-in. See the [notifications guide](/v2/guides/notifications) for the full list.

## Errors

* `401 UNAUTHORIZED` — missing or invalid API key.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Account tasks" href="/v2/storefront/account/tasks" icon="list-check">
    All account operations
  </Card>

  <Card title="Update notification preferences" href="/v2/storefront/account/tasks/update-notification-preferences" icon="bell-on">
    Replace your opt-ins
  </Card>

  <Card title="Account overview" href="/v2/storefront/account/overview" icon="building">
    Concepts and hierarchy
  </Card>
</CardGroup>