--- title: "GET /api/comments/{commentId}/replies" method: GET path: "/api/comments/{commentId}/replies" tags: ["comments"] --- # GET /api/comments/{commentId}/replies `GET /api/comments/{commentId}/replies` Return replies to a comment according to the comment id and additional criteria ## Path parameters - `commentId` string, required — The comment ID ## Query parameters - `author` string — Hex format string, e.g. `0x1234567890abcdef` - `viewer` string — The viewer's address - `app` string — The address of the app signer - `cursor` string — Non inclusive cursor from which to fetch the comments based on sort - `channelId` string — The channel ID - `commentType` integer, nullable — The comment type (e.g. 0=comment, 1=reaction, not passed = all) - `chainId` string, required — Filters by chain ID. Can be a single chain id or comma-separated list of chain ids (e.g. 1,137,10). - `moderationStatus` union — The moderation status of the comments to return. If omitted it will return comments based on moderation settings (approved if moderation is enabled). - 'approved' | 'rejected' | 'pending' - string[] - `moderationScore` number — The moderation score of the comments to return. If the comment's moderation score exceeds the provided value, it is not returned. - `excludeByModerationLabels` string — The moderation labels to exclude from the comments to return. This filter works in conjunction with the `moderationStatus` filter. - `limit` integer — The number of comments to return - `sort` 'asc' | 'desc' — The sort order of the comments - `mode` 'nested' | 'flat' — The mode to fetch comments in. Nested will return only the first level of comments. Flat will return all replies sorted by timestamp in descending order. - `isDeleted` string — Whether to return only deleted or only undeleted comments. If omitted it will return both deleted and undeleted comments. ## Response `200` Retrieve replies to the specified comment - object - `results` object[], required - `app` string, required — Hex format string, e.g. `0x1234567890abcdef` - `author` object, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `ens` object - `name` string, required - `avatarUrl` string, nullable, required - `farcaster` object - `fid` integer, required - `pfpUrl` string - `displayName` string - `username` string, required - `id` string, required — Hex format string, e.g. `0x1234567890abcdef` - `channelId` string, required - `commentType` integer, required - `content` string, required - `chainId` integer, required - `deletedAt` string, nullable, required - `logIndex` integer, nullable, required - `metadata` object[], required - `key` string, required — Hex format string, e.g. `0x1234567890abcdef` - `value` string, required — Hex format string, e.g. `0x1234567890abcdef` - `hookMetadata` object[], required - `key` string, required — Hex format string, e.g. `0x1234567890abcdef` - `value` string, required — Hex format string, e.g. `0x1234567890abcdef` - `parentId` string, nullable, required — Hex format string, e.g. `0x1234567890abcdef` - `targetUri` string, required - `txHash` string, required — Hex format string, e.g. `0x1234567890abcdef` - `cursor` string, required — Hex format string, e.g. `0x1234567890abcdef` - `moderationStatus` 'approved' | 'rejected' | 'pending', required - `moderationStatusChangedAt` string, nullable, required - `moderationClassifierResult` object, required - `moderationClassifierScore` number, required - `createdAt` string, nullable, required - `updatedAt` string, nullable, required - `revision` integer, required - `zeroExSwap` object, nullable, required - `from` object, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `amount` string, required - `symbol` string, required - `to` object, required - `address` union, required — Hex format string, e.g. `0x1234567890abcdef` - string — Hex format string, e.g. `0x1234567890abcdef` - '' - `amount` union, required - string - '' - `symbol` string, required - `references` union[], required - union - object - `type` 'ens', required - `avatarUrl` string, nullable, required - `name` string, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `position` object, required - `start` integer, required - `end` integer, required - `url` string, uri, required - object - `type` 'erc20', required - `symbol` string, required - `logoURI` string, nullable, required - `name` string, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `decimals` integer, required - `position` object, required - `start` integer, required - `end` integer, required - `chainId` integer, nullable, required - `chains` object[], required - `caip` string, required - `chainId` integer, required - object - `type` 'farcaster', required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `fid` integer, required - `fname` string, required - `username` string, required - `displayName` string, nullable, required - `pfpUrl` string, nullable, required - `position` object, required - `start` integer, required - `end` integer, required - `url` string, uri, required - object - `type` 'webpage', required - `url` string, uri, required - `position` object, required - `start` integer, required - `end` integer, required - `title` string, required - `description` string, nullable, required - `favicon` string, uri, nullable, required - `opengraph` object, nullable, required - `title` string, required - `description` string, nullable, required - `image` string, uri, required - `url` string, uri, required - `mediaType` string, required - object - `type` 'file', required - `url` string, uri, required - `position` object, required - `start` integer, required - `end` integer, required - `mediaType` string, required - object - `type` 'image', required - `url` string, uri, required - `position` object, required - `start` integer, required - `end` integer, required - `mediaType` string, required - `dimension` object - `width` integer, required - `height` integer, required - object - `type` 'video', required - `url` string, uri, required - `position` object, required - `start` integer, required - `end` integer, required - `mediaType` string, required - `videoTracks` object[] - `dimension` object, required - … - `codec` string - object - `type` 'quoted_comment', required - `id` string, required — Hex format string, e.g. `0x1234567890abcdef` - `chainId` integer, required - `position` object, required - `start` integer, required - `end` integer, required - unknown - unknown - `path` string, required - `viewerReactions` object, required - `reactionCounts` object, required - `replies` object, required - `extra` object, required - `moderationEnabled` boolean, required - `moderationKnownReactions` string[], required - `pagination` object, required - `limit` integer, required - `hasNext` boolean, required - `hasPrevious` boolean, required - `startCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `endCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `count` integer, required - `results` object[], required - `app` string, required — Hex format string, e.g. `0x1234567890abcdef` - `author` object, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `ens` object - `name` string, required - `avatarUrl` string, nullable, required - `farcaster` object - `fid` integer, required - `pfpUrl` string - `displayName` string - `username` string, required - `id` string, required — Hex format string, e.g. `0x1234567890abcdef` - `channelId` string, required - `commentType` integer, required - `content` string, required - `chainId` integer, required - `deletedAt` string, nullable, required - `logIndex` integer, nullable, required - `metadata` object[], required - `key` string, required — Hex format string, e.g. `0x1234567890abcdef` - `value` string, required — Hex format string, e.g. `0x1234567890abcdef` - `hookMetadata` object[], required - `key` string, required — Hex format string, e.g. `0x1234567890abcdef` - `value` string, required — Hex format string, e.g. `0x1234567890abcdef` - `parentId` string, nullable, required — Hex format string, e.g. `0x1234567890abcdef` - `targetUri` string, required - `txHash` string, required — Hex format string, e.g. `0x1234567890abcdef` - `cursor` string, required — Hex format string, e.g. `0x1234567890abcdef` - `moderationStatus` 'approved' | 'rejected' | 'pending', required - `moderationStatusChangedAt` string, nullable, required - `moderationClassifierResult` object, required - `moderationClassifierScore` number, required - `createdAt` string, nullable, required - `updatedAt` string, nullable, required - `revision` integer, required - `zeroExSwap` object, nullable, required - `from` object, required - `address` string, required — Hex format string, e.g. `0x1234567890abcdef` - `amount` string, required - `symbol` string, required - `to` object, required - `address` union, required — Hex format string, e.g. `0x1234567890abcdef` - … - `amount` union, required - … - `symbol` string, required - `references` union[], required - union - object - … - object - … - object - … - object - … - object - … - object - … - object - … - object - … - unknown - unknown - `path` string, required - `viewerReactions` object, required - `reactionCounts` object, required - `replies` object, required - `extra` object, required - `moderationEnabled` boolean, required - `moderationKnownReactions` string[], required - `pagination` object, required - `limit` integer, required - `hasNext` boolean, required - `hasPrevious` boolean, required - `startCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `endCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `count` integer, required - `results` unknown[], required - unknown - `pagination` object, required - `limit` integer, required - `hasNext` boolean, required - `hasPrevious` boolean, required - `startCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `endCursor` string — Hex format string, e.g. `0x1234567890abcdef` - `extra` object, required - `moderationEnabled` boolean, required - `moderationKnownReactions` string[], required ## Other responses - `400` — Bad request ## Changes - **2026-08-10** `fc5aae1cdc03` — 2 breaking, 56 info - the `results/items/replies/results/items/` response's property type/format changed from ``/`` to `object`/`` for status `200` - the `results/items/viewerReactions/additionalProperties/items/` response's property type/format changed from ``/`` to `object`/`` for status `200` - added the required property `results/items/replies/results/items/app` to the response with the `200` status - added the required property `results/items/replies/results/items/author` to the response with the `200` status - …54 more [Change history](https://skmtc.dev/ethcomments/apis/ethereum-comments-protocol-indexer-api/changes/api/comments/:commentId/replies/get.md) --- [API](https://skmtc.dev/ethcomments/apis/ethereum-comments-protocol-indexer-api.md) · [All operations](https://skmtc.dev/ethcomments/apis/ethereum-comments-protocol-indexer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ethcomments/ethereum-comments-protocol-indexer-api/revisions/fc5aae1cdc03/schema)