> ## 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 comments by user
> Fetch a page of a user's comment history
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
`useFetchCommentsByUserId` returns a function that fetches one page of a user's comments ([`GET /users/:userId/comments`](/v8/api-reference/users/fetch-comments-by-user-id)) — top-level comments and replies alike, across entities, cursor-paginated. For a stateful list with "load more", use [`useFetchCommentsByUserIdWrapper`](/v8/hooks/comments/use-fetch-comments-by-user-id-wrapper).
What the list contains:
* Deleted comments are left out. Moderator-removed comments are left out of other people's history, and included in full (marked `moderationStatus: "removed"`) in the signed-in user's own.
* Comments by users the signed-in user is block-edged with are left out by default (`blockedFilter`).
* Comments on an entity whose author has blocked the signed-in user are left out — except their own, which stay visible so they can be found and deleted. On those, `entity` and `parentComment` are `null` when requested, and replying, reacting and editing are refused.
* `include` never changes which comments are returned. `entity` is `null` when the entity isn't available to the signed-in user (for example, removed by a moderator) — the comment is still returned, and `null` doesn't say why.
## Usage Example
```tsx theme={null}
import { useFetchCommentsByUserId } from "@sublay/react-js";
function LatestComments({ userId }: { userId: string }) {
const fetchCommentsByUserId = useFetchCommentsByUserId();
const load = async () => {
const { data, pagination } = await fetchCommentsByUserId({
userId,
limit: 5,
include: ["entity"],
});
console.log(data, pagination.nextCursor);
};
return ;
}
```
## Parameters
The user whose comments to fetch.
Only comments on this entity.
Only comments on entities with this `sourceId`.
Server default `"exclude"`: comments by block-edged users are left out. `"include-outbound-blocked"` re-includes comments by users the signed-in user blocked, marked `isAuthorBlocked: true`.
Comments per page. Server default `10`, max `100`.
`pagination.nextCursor` from the previous response. Omit for the first page. Send the same sort as the request that returned it.
`"createdAt"`, `"top"` (raw count of `sortByReaction`) or `"controversial"`. Server default `"createdAt"`.
Applies to every sort. Server default `"desc"`.
With `sortBy: "top"` only. Server default `"upvote"`.
Related data to populate: `"user"`, `"entity"`, `"space"`, `"parent"`, `"grants"`.
## Returns
A `Promise>`:
The user's comments for this page. See [Comment](/v8/data-models/comment).
Pass as `cursor` to get the next page. `null` when there's nothing more.
Whether more comments exist after this page.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.