> ## 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 Following

> Get a paginated list of users that a specific user follows

Returns a paginated list of users that the specified user follows. This endpoint is public — no authentication required.

## Path Parameters

<ParamField path="userId" type="string" required>
  The Sublay user ID (UUID) of the user whose following list 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 follow entries.

  <Expandable title="item properties">
    <ResponseField name="followId" type="string">
      ID of the follow record.
    </ResponseField>

    <ResponseField name="user" type="object">
      Public profile of the followed user. Sensitive fields (email, hash, secureMetadata, etc.) are excluded.
    </ResponseField>

    <ResponseField name="followedAt" type="string">
      ISO timestamp of when the follow was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalCount" type="number">
  Total number of users being followed.
</ResponseField>

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

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

## See Also

* [`useFetchFollowing` hook](/hooks/follows/use-fetch-following)
* [`useFetchFollowingByUserId` hook](/hooks/follows/use-fetch-following-by-user-id)
* [Follow data model](/data-models/follow)