14. Notifications

14.1 List Notifications

GET /api/v1/notifications

Get user notifications.

Query Parameters:

• page - Page number
• limit - Items per page
• unreadOnly - Show only unread (default: false)

Response:

{
  "data": [
    {
      "id": "notif-001",
      "type": "high_value_lead",
      "title": "High-Value Lead Created",
      "message": "Nguyen Van A - Score: 95",
      "resourceId": "contact-001",
      "read": false,
      "createdAt": "2026-06-05T17:35:00Z"
    }
  ],
  "unreadCount": 5
}

---

14.2 Mark Notification as Read

POST /api/v1/notifications/:id/read

Mark notification as read.

Response: 200

{
  "message": "Notification marked as read"
}

---