GET /api/v1/notifications/unread

Returns only unread notifications for the authenticated user, ordered by creation date (newest first).

Authentication

Required. Bearer token in Authorization header.

Request

No query parameters.

Example

curl -X GET https://intotes.com/api/v1/notifications/unread \
  -H "Authorization: Bearer <access_token>"

Response

200 OK

[
  {
    "id": 1,
    "user_id": 7,
    "type": "trade_executed",
    "title": "Order Filled",
    "message": "Your order on 'Will BTC hit $100k?' was filled",
    "read": false,
    "created_at": "2026-04-04T12:30:00Z",
    "related_id": 42,
    "related_type": "event"
  }
]

Errors

Status	Code	Description
401	unauthorized	Missing or invalid authentication token
500	internal_error	Server failed to retrieve notifications