> ## 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. # List Messages > Fetch messages in a conversation or thread 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>. ; }; Returns a cursor-paginated list of [ChatMessage](/v8/data-models/chat-message) objects. By default returns the main conversation stream (excludes thread replies). Pass `parentId` to fetch replies for a specific thread. The caller must be a member. Former members (who left) can only read messages up to when they left. ## Path Parameters The ID of the conversation. ## Query Parameters If provided, returns thread replies to this message instead of the main stream. ISO 8601 timestamp. Returns messages created before this time. Used for loading older messages. Mutually exclusive with `after`. ISO 8601 timestamp. Returns messages created after this time. Used for loading newer messages. Mutually exclusive with `before`. Number of messages to return. Defaults to 50. Sort order: `asc` or `desc`. Defaults to `desc` for the main stream, `asc` for threads. Comma-separated list of extra fields to include: `files` (attachments) and `grants` (the [reputation-grant summary](/v8/data-models/reputation-grant#grantsummary)). Combine them as `include=files,grants`. Optional filters object, serialized as bracket-notation query params (e.g. `filters[hasReplies]=true`). * `hasReplies` (boolean) — When `true`, returns only messages that have thread replies (`threadReplyCount > 0`). When `false`, returns only messages with no thread replies. This filters by **thread replies**, not quotings (`quotedMessageId`). Threads are one level deep — a reply can never have its own replies. So `filters[hasReplies]=true` combined with `parentId` always returns an empty list; the response includes a `notice` field explaining why. ### Space-scoped reputation This endpoint has a space in context, so it accepts the opt-in reputation params. They add a `spaceReputation` field to each message sender's `user`, alongside the always-present `reputation` total. Requires the `reputation` bundle. See the [Reputation data model](/v8/data-models/reputation) for the full contract. ## Response Array of message objects. Each includes `reactionCounts`, `userReactions`, `user`, and `quotedMessage` fields. File attachments are included only when `include=files` is specified. Whether more messages exist in the requested direction. ISO timestamp of the oldest message in this page. `null` if no messages were returned. ISO timestamp of the newest message in this page. `null` if no messages were returned. Present only when a filter combination can't return results — e.g. `hasReplies: true` together with `parentId`. Explains why the list is empty. ## Error Responses ```json theme={null} { "error": "You are not a member of this conversation.", "code": "chat/not-a-member" } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.