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"
{
"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"
}
]
}
API
List code review comments
Posted code-review and issue comments with current feedback and pull-request attribution.
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"
{
"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"
}
]
}
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.
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. Missing repository access returns
Authorization
string
required
Bearer <key>. See Authentication.Path parameters
string
required
GITHUB_ORGANIZATION or GITHUB_USER.string
required
Numeric GitHub ID of the organization or user. Must match the key’s workspace.
Query parameters
Repeat list parameters, for examplerepositoryIds=1&repositoryIds=2. Omit a list to select all values; _UNSPECIFIED enum values are invalid filter inputs. Supplied lists must contain distinct values.
string
Inclusive UTC instant (RFC 3339). Defaults to 90 days before the resolved
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.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.string[]
Up to 100 positive GitHub IDs of pull-request authors, not comment authors. Encode int64 values as decimal strings.
string[]
POSITIVE or NEGATIVE, including feedback inferred from replies. Both values remove this filter.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.string
Case-insensitive literal substring of comment text, 1–256 characters. Percent and underscore are literal, not wildcards.
string[]
CORRECTNESS, IDIOM, TICKET_REQUIREMENTS or CUSTOM.string[]
OPEN, OPEN_DRAFT, CLOSED_MERGED or CLOSED_NOT_MERGED. Matches the current status, not status at endTime.string[]
Up to 100 exact custom-agent display names, each 1–256 characters.
string[]
REACTION or CLASSIFIER. A single source selects matching review comments and excludes issue comments. Both sources remove this filter.string[]
REVIEW_COMMENT (inline) or ISSUE_COMMENT (issue-level). Omit to include both.integer
default:"50"
Maximum comments per page, 1–200.
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
object[]
Matching comments on this page; omitted for an empty page.
Show properties
Show properties
string
GitHub repository ID.
string
Repository name in owner/name form.
string
GitHub pull-request number (int64).
string
GitHub ID of the pull-request author (int64), not the comment author.
string
GitHub login of the pull-request author.
string
Posted comment text.
string
Comment creation time (RFC 3339).
string
Link to the comment on GitHub.
boolean
Current positive feedback, including feedback inferred from replies.
boolean
Current negative feedback, including feedback inferred from replies.
boolean
Whether the review comment was addressed; always false for issue comments.
string
Current pull-request status.
string
Review category associated with the comment.
string
REVIEW_COMMENT or ISSUE_COMMENT.string
Source of current feedback.
string
Custom-agent display name, when available.
string
Custom-agent definition revision, when available.
string
Repository-relative custom-agent definition path, when available.
string
GitHub comment ID (int64), when available.
string
Opaque continuation. Follow it until absent. Repositories are reauthorized on the next request.
403; invalid filters, dates or tokens return 400.
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"
{
"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"
}
]
}