Reference

Just like the WordPress REST API, the BP REST API is organized around REST, and is designed to have predictable, resource-oriented URLs and to use HTTP response codes to indicate API errors. The API uses built-in HTTP features, like HTTP authentication and HTTP verbs, which can be understood by off-the-shelf HTTP clients, and supports cross-origin resource sharing to allow you to interact securely with the API from a client-side web application.

The BP REST API uses JSON exclusively as the request and response format, including error responses.

The BP REST API provides public data accessible to any client anonymously, as well as private data only available after authentication. Once authenticated the BP REST API supports most BuddyPress community actions, allowing you to enhance your plugins with more responsive management tools, or build complex single-page applications.

This API reference provides information on the specific endpoints available through the API, their parameters, and their response data format.

Developer Endpoint Reference

ResourceBase Route
Components/buddypress/v1/components
Members/buddypress/v1/members
Activity/buddypress/v1/activity
Extended Profiles:
Profile Group
Profile Field
Profile Data

/buddypress/v1/xprofile/groups
/buddypress/v1/xprofile/fields
/buddypress/v1/xprofile/<field_id>/data/<user_id>
User Groups:
Groups
Group Membership
Group Membership Requests
Group Invites

/buddypress/v1/groups
/buddypress/v1/groups/<group_id>/members
/buddypress/v1/groups/<group_id>/membership-request
/buddypress/v1/groups/<group_id>/invites
Private Messaging:
Sitewide Notices
/buddypress/v1/messages
/buddypress/v1/sitewide-notices
Screen Notifications/buddypress/v1/notifications
Attachments
Member Avatar
Member Cover Image
Group Avatar
Group Cover Image
Blog Avatar

/buddypress/v1/members/<user_id>/avatar
/buddypress/v1/members/<user_id>/cover
/buddypress/v1/groups/<group_id>/avatar
/buddypress/v1/groups/<group_id>/cover
/buddypress/v1/blogs/<id>/avatar
User Blogs/buddypress/v1/blogs
User Signups/buddypress/v1/signup
Friend Connections/buddypress/v1/friends