> ## Documentation Index > Fetch the complete documentation index at: https://docs.runaether.dev/llms.txt > Use this file to discover all available pages before exploring further. # List reviewed pull requests with their review runs > One group per reviewed pull request, in the requested order. include_unreviewed=true adds one group per other pull request of a repository the organization has a non-archived project for, with an empty reviews array, no verdict, a null comment_count, needs_attention false, and latest_created_at the pull request's open time; it is false when omitted, and reviews is never empty without it. A group with no runs takes its open time in place of its newest run in the default order; status=unreviewed matches it and every other status leaves it out. A list with include_unreviewed pages by cursor: send the previous page's next_cursor as cursor (absent on the last page); page above 1 is a 400, as is a cursor without include_unreviewed, a malformed cursor, or one minted for a different order or filter set. Grouping and the review-run status are resolved server-side so the listing can be paginated by group. needs_attention marks an open group requiring user action from its newest run or posted verdict; it does not affect ordering outside the queue. view=queue returns open pull requests only, needs_attention first. status and pr_state are comma-joined filters; status matches the group's LATEST run status — the status the list row displays — not any run in the group. viewer=author keeps the pull requests the caller opened and viewer=involved adds the ones they review, by the GitHub login their connection stores; every group carries the caller's viewer_standing. author, reviewer, repo_owner and repo_name match GitHub logins and repository coordinates case-insensitively; a reviewer has a user review request or a submitted review and is never the author. opened_after and updated_after (inclusive) and opened_before and updated_before (exclusive) are UTC instants bounding when the pull request was opened and GitHub's last update to it, and an empty window is a 400. A pull request mirrored before Aether kept GitHub's open time is dated by when Aether first saw it. order=importance (the default) is the newest activity first; order=opened is the newest opened first; order=updated is GitHub's last update first. view=queue puts attention ahead of any order. ## OpenAPI ````yaml api-reference/openapi.account.json GET /pr-reviews openapi: 3.1.0 info: title: Aether Account & Integrations API version: 0.1.0 description: >- Account, billing, and integration-management endpoints used by the Aether web app and CLI. Root-mounted; NOT part of the versioned /v1 contract. servers: - url: https://api.runaether.dev security: - bearerAuth: [] paths: /pr-reviews: get: tags: - pr-reviews summary: List reviewed pull requests with their review runs description: >- One group per reviewed pull request, in the requested order. include_unreviewed=true adds one group per other pull request of a repository the organization has a non-archived project for, with an empty reviews array, no verdict, a null comment_count, needs_attention false, and latest_created_at the pull request's open time; it is false when omitted, and reviews is never empty without it. A group with no runs takes its open time in place of its newest run in the default order; status=unreviewed matches it and every other status leaves it out. A list with include_unreviewed pages by cursor: send the previous page's next_cursor as cursor (absent on the last page); page above 1 is a 400, as is a cursor without include_unreviewed, a malformed cursor, or one minted for a different order or filter set. Grouping and the review-run status are resolved server-side so the listing can be paginated by group. needs_attention marks an open group requiring user action from its newest run or posted verdict; it does not affect ordering outside the queue. view=queue returns open pull requests only, needs_attention first. status and pr_state are comma-joined filters; status matches the group's LATEST run status — the status the list row displays — not any run in the group. viewer=author keeps the pull requests the caller opened and viewer=involved adds the ones they review, by the GitHub login their connection stores; every group carries the caller's viewer_standing. author, reviewer, repo_owner and repo_name match GitHub logins and repository coordinates case-insensitively; a reviewer has a user review request or a submitted review and is never the author. opened_after and updated_after (inclusive) and opened_before and updated_before (exclusive) are UTC instants bounding when the pull request was opened and GitHub's last update to it, and an empty window is a 400. A pull request mirrored before Aether kept GitHub's open time is dated by when Aether first saw it. order=importance (the default) is the newest activity first; order=opened is the newest opened first; order=updated is GitHub's last update first. view=queue puts attention ahead of any order. operationId: listPRReviews parameters: - explode: false in: query name: page schema: format: int64 minimum: 1 type: integer - explode: false in: query name: limit schema: format: int64 maximum: 100 minimum: 1 type: integer - explode: false in: query name: project_id schema: format: uuid type: string - explode: false in: query name: view schema: enum: - queue type: string - explode: false in: query name: status schema: pattern: >- ^(reviewing|completed|failed|cancelled|superseded|archived|unreviewed)(,(reviewing|completed|failed|cancelled|superseded|archived|unreviewed))*$ type: string - explode: false in: query name: pr_state schema: pattern: ^(open|closed|merged)(,(open|closed|merged))*$ type: string - explode: false in: query name: viewer schema: enum: - author - involved type: string - explode: false in: query name: author schema: pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$ type: string - explode: false in: query name: reviewer schema: pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$ type: string - explode: false in: query name: repo_owner schema: pattern: ^[A-Za-z0-9][A-Za-z0-9_-]*(\[[bB][oO][tT]\])?$ type: string - explode: false in: query name: repo_name schema: pattern: ^[A-Za-z0-9._-]+$ type: string - explode: false in: query name: opened_after schema: format: date-time pattern: >- ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$ type: string - explode: false in: query name: opened_before schema: format: date-time pattern: >- ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$ type: string - explode: false in: query name: updated_after schema: format: date-time pattern: >- ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$ type: string - explode: false in: query name: updated_before schema: format: date-time pattern: >- ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]{1,6})?Z$ type: string - explode: false in: query name: order schema: enum: - importance - opened - updated type: string - explode: false in: query name: include_unreviewed schema: type: boolean - explode: false in: query name: cursor schema: type: string responses: '200': content: application/json: schema: additionalProperties: false properties: groups: items: $ref: '#/components/schemas/PRReviewGroup' type: array next_cursor: minLength: 1 type: string pagination: $ref: '#/components/schemas/PaginationMeta' required: - groups - pagination type: object description: OK '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/OrgAuthorizationErrorResponse' description: Forbidden '422': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unprocessable Entity '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Internal Server Error components: schemas: PRReviewGroup: additionalProperties: false properties: additions: format: int64 minimum: 0 type: integer base_branch: type: string checks_failed: format: int64 minimum: 0 type: integer checks_passed: format: int64 minimum: 0 type: integer checks_total: format: int64 minimum: 0 type: integer ci_status: $ref: '#/components/schemas/TaskCIStatus' comment_count: format: int64 minimum: 0 type: - integer - 'null' deletions: format: int64 minimum: 0 type: integer draft: type: boolean github_updated_at: format: date-time type: string guide_outline: items: $ref: '#/components/schemas/PRReviewGuideOutlineSection' maxItems: 50 minItems: 1 type: array head_branch: type: string head_sha: type: string html_url: type: string latest_created_at: format: date-time type: string merged_at: format: date-time type: string needs_attention: type: boolean origin_task: $ref: '#/components/schemas/PRReviewOriginTask' pr_number: format: int64 minimum: 1 type: integer pr_state: $ref: '#/components/schemas/TaskGitHubPRState' pull_request_id: format: uuid type: string ready_for_merge: type: boolean repo_name: type: string repo_owner: type: string reviews: items: $ref: '#/components/schemas/PRReviewRun' type: array severity_counts: $ref: '#/components/schemas/PRReviewSeverityCounts' stack_children: items: $ref: '#/components/schemas/PullRequestStackEdge' minItems: 1 type: array stack_parent: $ref: '#/components/schemas/PullRequestStackEdge' summary_severity: $ref: '#/components/schemas/PRReviewSummarySeverity' title: type: string verdict: $ref: '#/components/schemas/PRReviewSummaryVerdict' viewer_standing: $ref: '#/components/schemas/PRReviewViewerStanding' required: - pull_request_id - pr_number - title - html_url - repo_owner - repo_name - checks_passed - checks_failed - checks_total - additions - deletions - latest_created_at - comment_count - needs_attention - reviews - draft - github_updated_at - ready_for_merge - viewer_standing type: object PaginationMeta: additionalProperties: false properties: has_more: type: boolean page: format: int64 minimum: 1 type: integer required: - page - has_more type: object ErrorResponse: additionalProperties: false properties: code: type: string error: minLength: 1 type: string errors: items: $ref: '#/components/schemas/ErrorDetail' type: array required: - error type: object OrgAuthorizationErrorResponse: additionalProperties: false properties: code: enum: - org_membership_required - org_role_insufficient - org_suspended - account_deleting type: string error: minLength: 1 type: string required: - error - code type: object TaskCIStatus: enum: - pending - passed - failed type: string PRReviewGuideOutlineSection: additionalProperties: false properties: paths: items: minLength: 1 pattern: "[^\t-\r \N\_  - \L\P  　\uFEFF]" type: string maxItems: 20 type: array title: maxLength: 200 minLength: 1 pattern: "[^\t-\r \N\_  - \L\P  　\uFEFF]" type: string x-aether-string-length-unit: unicode-code-point required: - title - paths type: object PRReviewOriginTask: additionalProperties: false properties: id: format: uuid type: string turn_count: format: int64 minimum: 0 type: integer required: - id - turn_count type: object TaskGitHubPRState: enum: - open - closed - merged type: string PRReviewRun: additionalProperties: false properties: agent_type: enum: - codex - claude-code - opencode - cursor type: string created_at: format: date-time type: string duration_seconds: format: int64 minimum: 0 type: integer error: type: string head_sha: type: string id: format: uuid type: string model: minLength: 1 type: string status: $ref: '#/components/schemas/ReviewRunStatus' trigger: $ref: '#/components/schemas/TaskReviewTrigger' required: - id - status - created_at - agent_type - model type: object PRReviewSeverityCounts: additionalProperties: false properties: confirmed: format: int64 minimum: 0 type: integer nit: format: int64 minimum: 0 type: integer p1: format: int64 minimum: 0 type: integer p2: format: int64 minimum: 0 type: integer question: format: int64 minimum: 0 type: integer required: - p1 - p2 - nit - question - confirmed type: object PullRequestStackEdge: additionalProperties: false description: >- One tracked open pull request on a branch-chain edge: as stack_parent, the pull request whose head repository and branch match this pull request's base; as an element of stack_children, a pull request whose base branch is this pull request's head. Present only when the edge exists in Aether's tracked pull-request projection; absence does not prove the pull request is unstacked. properties: html_url: format: uri pattern: ^[hH][tT][tT][pP][sS]?:// type: string pr_number: format: int64 minimum: 1 type: integer pull_request_id: format: uuid type: string state: enum: - open type: string title: type: string required: - pull_request_id - pr_number - title - state - html_url type: object PRReviewSummarySeverity: enum: - p1 - p2 - nit type: string PRReviewSummaryVerdict: enum: - APPROVE - REQUEST_CHANGES - COMMENT - DISMISSED - SUPERSEDED type: string PRReviewViewerStanding: enum: - author - pending - approved - changes_requested - commented - dismissed - none type: string ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object ReviewRunStatus: enum: - reviewing - completed - failed - cancelled - superseded - archived type: string TaskReviewTrigger: enum: - automatic - comment_command - manual type: string securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.