Fetch Spaces
Space Endpoints
Fetch Spaces
Get a paginated list of spaces with filtering and sorting
GET
Fetch Spaces
Fetches a paginated list of spaces. Supports filtering by search query, membership, and parent space. Authentication is optional — if provided, member-only spaces the user belongs to are included.
See also: useFetchManySpaces
This is a discovery surface: only
public spaces are listed. Spaces with visibility of "unlisted" or "private" are excluded for non-members (they remain reachable by direct link/slug via Fetch Space by Slug or by Short ID). The exception is memberOf=true, which returns the caller’s own spaces regardless of visibility. See Space visibility.Query Parameters
Page number. Defaults to
1.Results per page.
Sort order:
"alphabetical", "newest", or "members". Defaults to "members".Filter by slug substring.
Filter by name substring.
Filter by description substring.
Search across name, slug, and description simultaneously.
When
true, returns only spaces where the authenticated user is an active member.Filter to child spaces of a specific parent. Pass
"null" for root-level spaces only.Optional comma-separated includes. Pass
"files" to include avatar file objects.
