The plugin exposes group reviews under the BuddyPress REST namespace buddypress/v1. This backs mobile apps and headless front ends.
Endpoints
Section titled “Endpoints”Collection
Section titled “Collection”/wp-json/buddypress/v1/groups/{group_id}/reviews
| Method | Auth | Purpose |
|---|---|---|
| GET | Public for public groups; members or bp_moderate for private and hidden groups (since 3.9.1) |
List a group’s reviews. Supports page (default 1; 0 is treated as 1) and per_page (default 10; values above 100 are capped at 100). |
| POST | Logged-in user, must be a member of the group | Create a review. |
Create parameters: subject (required), description (required), ratings (optional array of per-criterion scores).
Single review
Section titled “Single review”/wp-json/buddypress/v1/groups/{group_id}/reviews/{review_id}
| Method | Auth | Purpose |
|---|---|---|
| GET | Public for public groups; members or bp_moderate for private and hidden groups (since 3.9.1) |
Fetch one review. |
| PUT / PATCH | Permission check (author or capable user) | Update subject, description, or ratings. |
| DELETE | Permission check (author or capable user) | Delete the review. |
- The collection GET and single GET are public for public groups. For private and hidden groups they need group membership or
bp_moderate(since 3.9.1). - A group excluded from reviews returns
403with the coderest_group_excludedon both listing and creating (since 3.9.2). - Creating a review requires an authenticated user who is a member of the target group; non-members are rejected.
group_idandreview_idare validated as numeric and sanitized withabsint.- Both routes expose a schema via the endpoint’s
schemacallback.
Example
Section titled “Example”# List reviews for group 42curl https://example.com/wp-json/buddypress/v1/groups/42/reviews?per_page=5
# Create a review (authenticated request)curl -X POST https://example.com/wp-json/buddypress/v1/groups/42/reviews \ -H "Content-Type: application/json" \ -d '{"subject":"Great group","description":"Very active.","ratings":[5,4,5]}'
