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

# Get user notifications

`GET /api/notifications`

## Request

- Base URL: `https://api.hiyd.ai`
- URL: `https://api.hiyd.ai/api/notifications`
- Auth: HTTP bearer

The inbox: notifications that were sent (status sent, delivered or read) and are meant for it. Queued reminders and outbox-only pushes (sync nudges) are not listed. `unread_count` uses the same filter. Does not require completed onboarding.

## Query parameters

- `status` 'unread' | 'read' | 'all'
- `type` 'health_alert' | 'goal_reminder' | 'achievement' | 'social' | 'system' | 'marketing'
- `page` integer
- `limit` integer

## Response `200`

Notifications retrieved successfully

---

[API](https://skmtc.dev/hiyd/apis/hiyd-backend-api.md) - [All operations](https://skmtc.dev/hiyd/apis/hiyd-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiyd/apis/hiyd-backend-api/revisions/23598d347e1b?raw)