GET /api/v1/notifications

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

Authentication

Required. Bearer token in Authorization header.

Request

Parameter	Type	In	Description
limit	integer	query	Maximum notifications to return (default: 20)
offset	integer	query	Number to skip for pagination (default: 0)

Example

curl -X GET "https://intotes.com/api/v1/notifications?limit=20&offset=0" \
  -H "Authorization: Bearer <access_token>"

Response

200 OK

Returns an array of Notification objects.

[
  {
    "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"
  },
  {
    "id": 2,
    "user_id": 7,
    "type": "event_resolved",
    "title": "Event Resolved",
    "message": "Event 'Champions League Final' has been resolved",
    "read": true,
    "created_at": "2026-04-03T18:00:00Z",
    "read_at": "2026-04-03T18:05:00Z",
    "related_id": 55,
    "related_type": "event"
  }
]

Errors

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