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

# Get notifications

`GET /api/notifications`

Get all notifications received by the current user. By default returns the 20 most recent notifications.

## Query parameters

- `limit` integer — Number of notifications to return (default: 20, most recent)
- `cursor` string, nullable — Cursor for the next page.
- `notification_type` string, nullable — Filter by notification type (chat, booking, payment, subscription, event, general, daily_morning, daily_evening)
- `success_only` boolean, nullable — Filter by success status (true for successful only, false for failed only, null for all)

## Response `200`

Successful Response

- NotificationsListResponse — Response model for list of notifications.
  - `notifications` NotificationResponse[], required — List of notifications
    - `id` string, uuid, required — Notification ID
    - `user_id` string, uuid, required — Recipient user ID
    - `notification_type` 'chat' | 'booking' | 'payment' | 'subscription' | 'event' | 'general' | 'daily_morning' | 'daily_evening' | 'lunch' | 'journey' | 'corabea_plus' | 'diary_shared' | 'kit_document', required — Notification type constants for FCM notifications.
    - `title` string, required — Notification title
    - `body` string, required — Notification body
    - `data` object, nullable — Notification data payload
    - `notification_metadata` object, nullable — Additional metadata
    - `sent_at` string, required — Timestamp when notification was sent
    - `success` boolean, required — Whether notification was successfully sent
    - `error_message` string, nullable — Error message if failed
    - `fcm_token` string, nullable — FCM token used (truncated)
  - `total` integer, required — Total number of notifications
  - `next_cursor` string, nullable — Cursor for the next page.
  - `has_more` boolean — Whether there are more results after this page

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)