Skip to content

Returns up to 50 unread notifications for the current user with the unread total, for the notification dropdown.

Not paginated. notification_type narrows the list; it defaults to all.

Endpoint

  • Method: GET

  • Path: /notifications/unread

  • Edition: Core

  • Controller: NotificationsController@getUnreadNotifications

  • Route source: fluent-community/app/Http/Routes/api.php:132

  • Controller source: fluent-community/app/Http/Controllers/NotificationsController.php

  • Requires a signed-in user.

Live sample

The request and response below were recorded against a running FluentCommunity install and then anonymised — member names, emails, avatars and post content are fictional, and long collections are trimmed to a few entries.

GET List Unread Notifications

GET
/notifications/unread

Returns up to 50 unread notifications for the current user with the unread total, for the notification dropdown.

Controller: NotificationsController@getUnreadNotifications
Route source: fluent-community/app/Http/Routes/api.php:132

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Parameters

Query Parameters

notification_type

Notification Type read via $request->get() in getUnreadNotifications().

Type
string
Default
"all"

Responses

Successful response

application/json
JSON
{
  
"notifications": [
  
  
{
  
  
  
"action": "string",
  
  
  
"content": "string",
  
  
  
"created_at": "string",
  
  
  
"feed_id": "string",
  
  
  
"id": 0,
  
  
  
"object_id": "string",
  
  
  
"route": {
  
  
  
  
"name": "string",
  
  
  
  
"params": {
  
  
  
  
  
"feed_slug": "string",
  
  
  
  
  
"space": "string"
  
  
  
  
}
  
  
  
},
  
  
  
"src_object_type": "string",
  
  
  
"src_user_id": "string",
  
  
  
"title": "string",
  
  
  
"updated_at": "string",
  
  
  
"xprofile": "string"
  
  
}
  
],
  
"unread_count": 0
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation