List Notifications

Updated about 2 hours ago•1 min read
GET

/v1/notifications

Returns a paginated list of notifications for the current authenticated user with optional unread filter.

Parameters

NameTypeDescription
unreadbooleanFilter by unread notifications only
pageintegerPage number
per_pageintegerRecords per page

Responses

200List of notifications
{
  "data": [
    {
      "id": "ntf_501",
      "notification_type": "conversation_assigned",
      "read_at": null,
      "message": "You were assigned to conversation #CNV-1029",
      "created_at": "2026-09-02T14:10:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1
  }
}