Members

The Members API allows you to list, search, and discover community members.

Member Object

A member represents a user in the community with basic profile information.

Properties

Property	Type	Description
`id`	integer	User ID
`username`	string	Unique username
`display_name`	string	Display name
`avatar`	string	Avatar image URL
`bio`	string	Short biography
`location`	string	Location
`role`	string	User role (member, moderator, admin)
`status`	string	Account status (active, suspended)
`badges`	array	Earned badges
`stats`	object	User statistics
`created_at`	datetime	Registration timestamp
`last_seen`	datetime	Last activity timestamp

List All Members

Retrieve a paginated list of community members.

HTTP Request

GET /wp-json/fluent-community/v2/members

Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number
`per_page`	integer	20	Items per page (max: 100)
`role`	string	-	Filter by role
`status`	string	active	Filter by status
`orderby`	string	created_at	Sort field (created_at, display_name, last_seen)
`order`	string	desc	Sort order (asc, desc)
`space_id`	integer	-	Filter by space membership

Example Request

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members?per_page=20&orderby=last_seen" \
  -u "username:password"

Example Response

json

{
  "members": {
    "current_page": 1,
    "data": [
      {
        "user_id": 1,
        "total_points": 6425,
        "is_verified": 1,
        "status": "active",
        "display_name": "User Name",
        "username": "username",
        "avatar": "avatar_url",
        "created_at": "2024-03-05 16:37:02",
        "short_description": "User description",
        "meta": {
          "website": "website_url",
          "cover_photo": "cover_photo_url",
          "social_links": {
            "twitter": "@handle",
            "youtube": "@handle",
            "linkedin": "handle",
            "fb": "handle",
            "instagram": "handle"
          },
          "badge_slug": ["badge1", "badge2"]
        },
        "last_activity": "2025-10-29 06:55:33",
        "badge": null
      }
    ],
    "first_page_url": "https://community.test/wp-json/fluent-community/v2/members/?page=1",
    "from": 1,
    "last_page": 72,
    "last_page_url": "https://community.test/wp-json/fluent-community/v2/members/?page=72",
    "links": [
      {
        "url": null,
        "label": "pagination.previous",
        "active": false
      },
      {
        "url": "https://community.test/wp-json/fluent-community/v2/members/?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "https://community.test/wp-json/fluent-community/v2/members/?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": null,
        "label": "pagination.next",
        "active": false
      }
    ],
    "next_page_url": "https://community.test/wp-json/fluent-community/v2/members/?page=2",
    "path": "https://community.test/wp-json/fluent-community/v2/members",
    "per_page": 20,
    "prev_page_url": null,
    "to": 20,
    "total": 1250
  },
  "execution_time": 0.123
}

Search Members

Search for members by name, username, or email using the search query parameter.

HTTP Request

GET /wp-json/fluent-community/v2/members?search={query}

Parameters

Parameter	Type	Required	Description
`search`	string	Yes	Search query (name, username, or email)
`per_page`	integer	No	Results limit (default: 20, max: 100)
`page`	integer	No	Page number for pagination

Example Request

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members?search=john&per_page=10" \
  -u "username:password"

Example Response

json

{
  "members": {
    "current_page": 1,
    "data": [
      {
        "user_id": 1,
        "username": "john_doe",
        "display_name": "John Doe",
        "avatar": "https://example.com/avatar.jpg",
        "short_description": "Community enthusiast",
        "total_points": 150,
        "is_verified": 1,
        "status": "active"
      },
      {
        "user_id": 15,
        "username": "johnny_smith",
        "display_name": "Johnny Smith",
        "avatar": "https://example.com/avatar2.jpg",
        "short_description": "Tech lover",
        "total_points": 89,
        "is_verified": 0,
        "status": "active"
      }
    ],
    "total": 2,
    "per_page": 10
  },
  "execution_time": 0.045
}

Get Active Members

Retrieve currently active members.

HTTP Request

GET /wp-json/fluent-community/v2/members/active

Parameters

Parameter	Type	Default	Description
`per_page`	integer	10	Items per page
`minutes`	integer	15	Active within last X minutes

Example Request

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members/active?per_page=10" \
  -u "username:password"

Example Response

json

{
  "data": [
    {
      "id": 1,
      "username": "john_doe",
      "display_name": "John Doe",
      "avatar": "https://example.com/avatar.jpg",
      "last_seen": "2025-10-27T11:55:00",
      "is_online": true
    }
  ],
  "meta": {
    "total_online": 12
  }
}

Get New Members

Retrieve recently joined members.

HTTP Request

GET /wp-json/fluent-community/v2/members/new

Parameters

Parameter	Type	Default	Description
`per_page`	integer	10	Items per page
`days`	integer	7	Joined within last X days

Example Request

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members/new?per_page=5" \
  -u "username:password"

Get Top Contributors

Retrieve members with the most activity.

HTTP Request

GET /wp-json/fluent-community/v2/members/top-contributors

Parameters

Parameter	Type	Default	Description
`per_page`	integer	10	Items per page
`period`	string	month	Time period (week, month, year, all)
`metric`	string	posts	Sort by metric (posts, comments, reactions)

Example Request

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members/top-contributors?period=month&metric=posts" \
  -u "username:password"

Example Response

json

{
  "data": [
    {
      "id": 1,
      "username": "john_doe",
      "display_name": "John Doe",
      "avatar": "https://example.com/avatar.jpg",
      "stats": {
        "posts_count": 45,
        "comments_count": 128,
        "reactions_received": 234
      },
      "rank": 1
    }
  ]
}

Best Practices

1. Pagination

Always use pagination for large member lists:

bash

# First page
curl ".../members?page=1&per_page=20"

# Next page
curl ".../members?page=2&per_page=20"

2. Search Optimization

Use specific search queries for better results:

bash

# Search by username
curl ".../members?search=john_doe"

# Search by display name
curl ".../members?search=John%20Doe"

3. Filtering

Combine filters for targeted results:

bash

# Active moderators
curl ".../members?role=moderator&status=active"

# Members in a specific space
curl ".../members?space_id=5"

4. Caching

Cache member lists for better performance:

javascript

// Cache for 5 minutes
const cacheKey = 'members_list';
const cached = localStorage.getItem(cacheKey);

if (cached && Date.now() - cached.timestamp < 300000) {
  return cached.data;
}

// Fetch fresh data
const members = await fetchMembers();
localStorage.setItem(cacheKey, {
  data: members,
  timestamp: Date.now()
});

Common Use Cases

Member Directory

Create a searchable member directory:

bash

# Get all members
curl ".../members?per_page=50&orderby=display_name&order=asc"

# Add search functionality
curl ".../members?search=john"

Welcome New Members

Display recently joined members:

bash

curl "https://your-site.com/wp-json/fluent-community/v2/members/new?per_page=5&days=7" \
  -u "username:password"

Show who's currently online:

bash

# Get active members
curl ".../members/active?per_page=10&minutes=15"

# Update every minute
setInterval(() => {
  fetchActiveMembers();
}, 60000);

Leaderboard

Create a contributor leaderboard:

bash

# Top contributors this month
curl ".../members/top-contributors?period=month&per_page=10"

# Display rankings

Member Suggestions

Suggest members to follow or connect with:

bash

# Get members with similar interests
curl ".../members?space_id=5&per_page=10"

# Search with filters
curl ".../members?search=tech&per_page=10"

Space Member Invites

Find members to invite to a space:

bash

# Search for members not in space
curl ".../members?search=john"

# Check if member is in space
curl ".../spaces/tech-talk/members"

# Invite member
curl -X POST ".../spaces/tech-talk/members" -d '{
  "user_id": 10
}'

Error Handling

No Results Found (200)

json

{
  "data": [],
  "meta": {
    "total": 0
  }
}

Invalid Search Query (400)

json

{
  "code": "invalid_search",
  "message": "Search query must be at least 2 characters",
  "data": {
    "status": 400
  }
}

Invalid Filter (400)

json

{
  "code": "invalid_filter",
  "message": "Invalid role filter",
  "data": {
    "status": 400,
    "allowed_values": ["member", "moderator", "admin"]
  }
}

Profiles - View detailed user profiles
Followers - Follow/unfollow members [PRO]
Space Members - Manage space membership
Spaces - Filter members by space

Members ​

Member Object ​

Properties ​

List All Members ​

Parameters ​

Example Request ​

Example Response ​

Search Members ​

Parameters ​

Example Request ​

Example Response ​

Get Active Members ​

Parameters ​

Example Request ​

Example Response ​

Get New Members ​

Parameters ​

Example Request ​

Get Top Contributors ​

Parameters ​

Example Request ​

Example Response ​

Best Practices ​

1. Pagination ​

2. Search Optimization ​

3. Filtering ​

4. Caching ​

Common Use Cases ​

Member Directory ​

Welcome New Members ​

Online Members Widget ​

Leaderboard ​

Member Suggestions ​

Space Member Invites ​

Error Handling ​

No Results Found (200) ​

Invalid Search Query (400) ​

Invalid Filter (400) ​

Related Endpoints ​

Members

Member Object

Properties

List All Members

Parameters

Example Request

Example Response

Search Members

Parameters

Example Request

Example Response

Get Active Members

Parameters

Example Request

Example Response

Get New Members

Parameters

Example Request

Get Top Contributors

Parameters

Example Request

Example Response

Best Practices

1. Pagination

2. Search Optimization

3. Filtering

4. Caching

Common Use Cases

Member Directory

Welcome New Members

Online Members Widget

Leaderboard

Member Suggestions

Space Member Invites

Error Handling

No Results Found (200)

Invalid Search Query (400)

Invalid Filter (400)

Related Endpoints