> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sublay.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Connections
> Get a paginated list of a user's accepted connections
export const SpaceReputationParams = ({variant = "context", field = "path"}) => {
const isUser = variant === "user";
return <>
Opt-in. Adds a spaceReputation number to each returned user,
scoped to a single space. Requires the reputation bundle.
The reputation total is always present regardless;{" "}
spaceReputation is purely additive and only appears when you
pass this object. This object is the primary form — it
replaces the deprecated flat props below. See the{" "}
Reputation data model for the
full contract.
{isUser ?
Which bucket to read. A space <uuid> reads that
space's bucket; "none" reads the
project-general (space-less) bucket.{" "}
"context" is rejected (400) on this
endpoint — there is no space context to derive. The empty string
and the legacy general / null aliases are
also rejected. Missing buckets read as 0.
:
Which bucket to read. One of: a space <uuid>{" "}
(that space's bucket), "none" (the
project-general, space-less bucket), or{" "}
"context" (the space derived from the
request context — resolved per-row on lists, or the single space on
member/team/conversation surfaces). The empty string and the legacy{" "}
general / null aliases are rejected (400).
Missing buckets read as 0.
}
Only honored when spaceId is an explicit space <uuid>.
When true, spaceReputation is the{" "}
subtree sum — the named space plus all of its
descendant spaces (the root space's own bucket included). Ignored for{" "}
"none"; not allowed with "context".
{isUser ?
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid> or "none" only —{" "}
"context" is rejected (400) on this endpoint.
:
Deprecated — use the spaceReputation{" "}
object instead. The flat form of spaceReputation.spaceId.
Still accepted (the object wins if both are passed); removal is a later
major version. Accepts a space <uuid>, "none", or{" "}
"context".
}
Deprecated — use{" "}
spaceReputation.includeDescendants instead. The flat form,
only honored alongside an explicit spaceReputationId <uuid>.
;
};
Returns a paginated list of accepted connections for the specified user. Each entry includes the connected user's public profile. Authentication is optional — the endpoint works without a token. When the caller is signed in, any user with a block between them and the caller, in either direction, is excluded from the results. Block filtering requires the `moderation` bundle.
## Path Parameters
The Sublay user ID (UUID) of the user whose connections to retrieve.
## Query Parameters
Page number for pagination. Defaults to `1`.
Number of results per page. Defaults to `20`, maximum `100`.
Optional search term. Filters the list to connections whose connected user's username or name contains this text (case-insensitive). When omitted, no filtering is applied.
Restricts which field `query` matches against — `username` or `name`. When omitted, `query` matches either field.
### Space-scoped reputation
This endpoint has no space in context, so the opt-in `spaceReputation` object accepts a `spaceId` of a space **``** or **`none`** only — `context` is rejected (400). It adds a `spaceReputation` field to each returned user, alongside the always-present `reputation` total. Requires the `reputation` bundle. See the [Reputation data model](/v8/data-models/reputation).
## Response
On success, returns HTTP `200` with a paginated response:
Array of connection entries.
Connection record ID.
Public profile of the connected user (the user who is not `:userId`). Sensitive fields are excluded.
ISO timestamp of when the connection was accepted.
Pagination metadata.
Current page number.
Page size used for this response.
Total number of pages.
Total number of accepted connections.
Whether more pages exist after this one.
## See Also
* [`useFetchConnectionsByUserId` hook](/v8/hooks/connections/use-fetch-connections-by-user-id)
* [Connection data model](/v8/data-models/connection)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.