> ## 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.
# Fetch followers by user ID
> Fetch the followers of any user by their ID
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>.
;
};
## Overview
Returns a function that fetches the paginated list of followers for any user, identified by `userId`. 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.
For fetching your own followers, see `useFetchFollowers`.
## Usage Example
```tsx theme={null}
import { useFetchFollowersByUserId } from "@sublay/react-js";
function UserFollowers({ userId }: { userId: string }) {
const fetchFollowersByUserId = useFetchFollowersByUserId();
const [followers, setFollowers] = useState([]);
useEffect(() => {
fetchFollowersByUserId({ userId, page: 1 }).then((res) => {
setFollowers(res.data);
});
}, [userId]);
return (
{followers.map(({ followId, user }) => (
- {user.name}
))}
);
}
```
## Parameters
The hook returns a function. That function accepts:
The ID of the user whose followers to fetch.
Page number to fetch. Defaults to `1`.
Number of results per page. Defaults to `20`.
Optional search term. Filters the list to users whose 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.
## Returns
Returns a `PaginatedResponse` containing an array of follower entries:
Array of follower entries.
ID of the follow record.
The follower's user profile. When `spaceReputation` is requested, it carries an added `spaceReputation` number. See [User data model](/v8/data-models/user) and [Reputation](/v8/data-models/reputation).
ISO timestamp of when the follow was created.
Pagination metadata including `currentPage`, `totalPages`, `totalCount`, `hasNextPage`, and `hasPreviousPage`.
## Related
* [useFetchFollowers](/v8/hooks/follows/use-fetch-followers) — fetch the current user's own followers
* [useFetchFollowersCountByUserId](/v8/hooks/follows/use-fetch-followers-count-by-user-id) — get follower count for a user
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.