> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macroscope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List code review comments

> Posted code-review and issue comments with current feedback and pull-request attribution.

Returns posted inline review comments and issue-level comments, newest first. Requires workspace Read and read access to every selected repository. Repositories are authorized again on every page. These are live results, not a historical snapshot: edits, deletions, feedback and pull-request state can change between requests.

## Authorization

**Authorization** `string` *required*

`Bearer <key>`. See [Authentication](https://docs.macroscope.com/api#authentication).

## Path parameters

**workspaceType** `string` *required*

`GITHUB_ORGANIZATION` or `GITHUB_USER`.

**workspaceId** `string` *required*

Numeric GitHub ID of the organization or user. Must match the key's workspace.

## Query parameters

Repeat list parameters, for example `repositoryIds=1&repositoryIds=2`. Omit a list to select all values; `_UNSPECIFIED` enum values are invalid filter inputs. Supplied lists must contain distinct values.

**startTime** `string`

Inclusive UTC instant (RFC 3339). Defaults to 90 days before the resolved `endTime`.

**endTime** `string`

Inclusive UTC instant (RFC 3339), not before `startTime`. Defaults to now. Boundaries are not rounded to calendar days; continuations retain the original resolved window.

**repositoryIds** `string[]`

Up to 100 GitHub repository IDs, each 1–128 characters. Omit for all readable active repositories. An explicitly inaccessible repository returns `403`; no readable repositories yields an empty page.

**authorIds** `string[]`

Up to 100 positive GitHub IDs of **pull-request authors**, not comment authors. Encode int64 values as decimal strings.

**reactions** `string[]`

`POSITIVE` or `NEGATIVE`, including feedback inferred from replies. Both values remove this filter.

**addressedOnly** `boolean`

`true` for addressed review comments, `false` for unaddressed review comments. Either supplied value excludes issue comments; omit to include both addressed states and issue comments.

**searchQuery** `string`

Case-insensitive literal substring of comment text, 1–256 characters. Percent and underscore are literal, not wildcards.

**reviewTypes** `string[]`

`CORRECTNESS`, `IDIOM`, `TICKET_REQUIREMENTS` or `CUSTOM`.

**prStatuses** `string[]`

`OPEN`, `OPEN_DRAFT`, `CLOSED_MERGED` or `CLOSED_NOT_MERGED`. Matches the current status, not status at `endTime`.

**customCheckNames** `string[]`

Up to 100 exact custom-agent display names, each 1–256 characters.

**feedbackSources** `string[]`

`REACTION` or `CLASSIFIER`. A single source selects matching review comments and excludes issue comments. Both sources remove this filter.

**commentTypes** `string[]`

`REVIEW_COMMENT` (inline) or `ISSUE_COMMENT` (issue-level). Omit to include both.

**pageSize** `integer` (default: 50)

Maximum comments per page, 1–200.

**pageToken** `string`

Opaque `nextPageToken`, at most 4096 characters. Bound to workspace, operation and filters; expires after 24 hours. Repeat original filters; `pageSize` may change. Invalid, expired, altered or mismatched tokens return `400`; restart without the token.

## Response

**comments** `object[]`

Matching comments on this page; omitted for an empty page.

**properties**

**repositoryId** `string`

GitHub repository ID.

**repositoryName** `string`

Repository name in owner/name form.

**pullRequestNumber** `string`

GitHub pull-request number (int64).

**authorId** `string`

GitHub ID of the pull-request author (int64), not the comment author.

**authorLogin** `string`

GitHub login of the pull-request author.

**text** `string`

Posted comment text.

**createTime** `string`

Comment creation time (RFC 3339).

**githubUrl** `string`

Link to the comment on GitHub.

**hasPositiveReaction** `boolean`

Current positive feedback, including feedback inferred from replies.

**hasNegativeReaction** `boolean`

Current negative feedback, including feedback inferred from replies.

**addressed** `boolean`

Whether the review comment was addressed; always false for issue comments.

**prStatus** `string`

Current pull-request status.

**reviewType** `string`

Review category associated with the comment.

**commentType** `string`

`REVIEW_COMMENT` or `ISSUE_COMMENT`.

**feedbackSource** `string`

Source of current feedback.

**customCheckName** `string`

Custom-agent display name, when available.

**customAgentCommit** `string`

Custom-agent definition revision, when available.

**customAgentFilePath** `string`

Repository-relative custom-agent definition path, when available.

**githubCommentId** `string`

GitHub comment ID (int64), when available.

**nextPageToken** `string`

Opaque continuation. Follow it until absent. Repositories are reauthorized on the next request.

False, zero, empty lists and default enum values are omitted from JSON. Optional custom-agent metadata and GitHub comment IDs are omitted when unavailable. A missing field is not a fabricated value.

See [shared errors and limits](https://docs.macroscope.com/api#errors). Missing repository access returns `403`; invalid filters, dates or tokens return `400`.

```bash cURL theme={null}
curl --get https://api.macroscope.com/api/v1/workspaces/GITHUB_ORGANIZATION/12345678/code-review-comments \
  -H "Authorization: Bearer $MACROSCOPE_API_KEY" \
  --data-urlencode "commentTypes=REVIEW_COMMENT" \
  --data-urlencode "pageSize=50"
```

```json 200 theme={null}
{
  "comments": [
    {
      "repositoryId": "123456789",
      "repositoryName": "acme/backend",
      "pullRequestNumber": "42",
      "authorId": "1234567",
      "authorLogin": "example-developer",
      "text": "Handle cancellation before processing the next item.",
      "createTime": "2026-10-01T12:00:00Z",
      "githubUrl": "https://github.com/acme/backend/pull/42#discussion_r1234567890",
      "prStatus": "OPEN",
      "reviewType": "CORRECTNESS",
      "commentType": "REVIEW_COMMENT"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.