> ## Documentation Index
> Fetch the complete documentation index at: https://replyke-feat-push-rich-payload-fields.mintlify.site/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

Returns a paginated list of accepted connections for the specified user. Each entry includes the connected user's public profile. This endpoint is public — no authentication required.

## Path Parameters

<ParamField path="userId" type="string" required>
  The Sublay user ID (UUID) of the user whose connections to retrieve.
</ParamField>

## Query Parameters

<ParamField query="page" type="number">
  Page number for pagination. Defaults to `1`.
</ParamField>

<ParamField query="limit" type="number">
  Number of results per page. Defaults to `20`, maximum `100`.
</ParamField>

### Space-scoped reputation

This endpoint has no space in context, so `spaceReputationId` accepts a space **`<uuid>`** 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](/data-models/reputation).

<ParamField query="spaceReputationId" type="string">
  Adds `spaceReputation` to each returned user. Either a space **`<uuid>`** (that space's bucket) or **`none`** (the project-general bucket). `context`, the empty string, and the legacy `general` / `null` aliases are rejected (400). Missing buckets read as `0`.
</ParamField>

<ParamField query="spaceReputationDescendants" type="boolean">
  Only honored with an explicit space `<uuid>`. When `true`, `spaceReputation` is the subtree sum — the space plus all of its descendants. Ignored for `none`.
</ParamField>

## Response

On success, returns HTTP `200` with a paginated response:

<ResponseField name="data" type="array">
  Array of connection entries.

  <Expandable title="item properties">
    <ResponseField name="id" type="string">
      Connection record ID.
    </ResponseField>

    <ResponseField name="connectedUser" type="object">
      Public profile of the connected user (the user who is not `:userId`). Sensitive fields are excluded.
    </ResponseField>

    <ResponseField name="connectedAt" type="string">
      ISO timestamp of when the connection was accepted.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalCount" type="number">
  Total number of accepted connections.
</ResponseField>

<ResponseField name="page" type="number">
  Current page number.
</ResponseField>

<ResponseField name="limit" type="number">
  Page size used for this response.
</ResponseField>

## See Also

* [`useFetchConnectionsByUserId` hook](/hooks/connections/use-fetch-connections-by-user-id)
* [Connection data model](/data-models/connection)