Skip to content

Returns a paginated directory of community members in the requested sort order, or the trimmed candidate list the mention autocomplete uses.

Passing mention switches the endpoint into autocomplete mode: at most ten matches, the current user excluded, and — when space or space_id is given — restricted to that space, which the caller must belong to. The directory mode instead honours search, sort_by (last_activity, display_name or created_at) and sort_dir, and is gated by the members_page_status privacy setting.

Endpoint

  • Method: GET

  • Path: /members

  • Edition: Core

  • Controller: MembersController@getMembers

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

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

  • Moderators may pass status to list pending, blocked or deactivated members; everyone else only ever sees active profiles.

  • When the members page is restricted the response is an error carrying permission_failed, not an empty list.

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 Members

GET
/members

Returns a paginated directory of community members in the requested sort order, or the trimmed candidate list the mention autocomplete uses.

Controller: MembersController@getMembers
Route source: fluent-community/app/Http/Routes/api.php:126

Authorizations

ApplicationPasswords

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

Type
API Key (header: Authorization)

Parameters

Query Parameters

mention

Mention read via $request->getSafe() in getMembers().

Type
string
space

Space read via $request->getSafe() in getMembers().

Type
string
space_id

Space ID read via $request->getSafe() in getMembers().

Type
string
sort_by

Sort By read via $request->getSafe() in getMembers().

Type
string
Default
"last_activity"
sort_dir

Sort Dir read via $request->getSafe() in getMembers().

Type
string
search

Search read via $request->getSafe() in getMembers().

Type
string
status

Status read via $request->getSafe() in getMembers().

Type
string
Default
"active"

Responses

Successful response

application/json
JSON
{
  
"current_user_follows": {
  
  
"76": "string",
  
  
"1628": "string",
  
  
"6764": "string"
  
},
  
"execution_time": 0,
  
"members": {
  
  
"current_page": 0,
  
  
"data": [
  
  
  
{
  
  
  
  
"avatar": "string",
  
  
  
  
"badge": "string",
  
  
  
  
"created_at": "string",
  
  
  
  
"display_name": "string",
  
  
  
  
"is_verified": 0,
  
  
  
  
"last_activity": "string",
  
  
  
  
"meta": {
  
  
  
  
  
"badge_slug": "string",
  
  
  
  
  
"cover_photo": "string",
  
  
  
  
  
"social_links": {
  
  
  
  
  
  
"fb": "string",
  
  
  
  
  
  
"instagram": "string",
  
  
  
  
  
  
"linkedin": "string",
  
  
  
  
  
  
"twitter": "string",
  
  
  
  
  
  
"youtube": "string"
  
  
  
  
  
},
  
  
  
  
  
"website": "string"
  
  
  
  
},
  
  
  
  
"permalink": "string",
  
  
  
  
"short_description": "string",
  
  
  
  
"status": "string",
  
  
  
  
"total_points": 0,
  
  
  
  
"user_id": 0,
  
  
  
  
"username": "string"
  
  
  
}
  
  
],
  
  
"first_page_url": "string",
  
  
"from": 0,
  
  
"last_page": 0,
  
  
"last_page_url": "string",
  
  
"links": [
  
  
  
{
  
  
  
  
"active": true,
  
  
  
  
"label": "string",
  
  
  
  
"url": "string"
  
  
  
}
  
  
],
  
  
"next_page_url": "string",
  
  
"path": "string",
  
  
"per_page": 0,
  
  
"prev_page_url": "string",
  
  
"to": 0,
  
  
"total": 0
  
}
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation