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

> Get a paginated list of users who follow a specific user

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

## Path Parameters

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

<ParamField query="query" type="string">
  Optional search term. Filters the list to users whose username or name contains this text (case-insensitive). When omitted, no filtering is applied.
</ParamField>

<ParamField query="searchFields" type="string">
  Restricts which field `query` matches against — `username` or `name`. When omitted, `query` matches either field.
</ParamField>

### Space-scoped reputation

This endpoint has no space in context, so the opt-in `spaceReputation` object accepts a `spaceId` of 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).

<SpaceReputationParams variant="user" field="query" />

## 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 follower 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 followers.
</ResponseField>

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

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

## See Also

* [`useFetchFollowers` hook](/hooks/follows/use-fetch-followers)
* [`useFetchFollowersByUserId` hook](/hooks/follows/use-fetch-followers-by-user-id)
* [Follow data model](/data-models/follow)