Skip to main content
Fetch User Spaces
Returns a paginated list of spaces the authenticated user has a membership in, along with their membership details for each space. By default only active memberships are returned; use status to list pending join requests or spaces the user was banned from.

Query Parameters

string
Membership status to list: "active" (default), "pending", or "banned"."pending" surfaces join requests still awaiting admin approval — useful for a “waiting to join” screen on spaces that have requireJoinApproval enabled.
number
Page number. Defaults to 1.
number
Results per page. Max 100.
string
Filter by role. Single value ("admin", "moderator", "member") or comma-separated list (e.g. "admin,moderator").
string
Optional comma-separated includes. Pass "files" to include avatar and banner file objects on each space.
string
Pass "true" to return all memberships without pagination. When used, the response omits the pagination field.

Response

UserSpaceItem[]
Each item contains a space and a membership object.
object
Standard pagination metadata.
See also: useFetchUserSpaces