> ## 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.

# Get a pull request's merge box and live checks

> The merge box comes from the pull request mirror; ci_status and the check counts come from the same live GitHub fetch as the checks list, so both halves of one response agree even while webhooks lag. Requires membership in the owning organization of a task linked to this pull request — the task that published it or a task that reviewed it — and current GitHub access to the repository. 404 covers an unknown pull request, one linked to no organization the caller belongs to, and one whose GitHub access the caller has lost; the three are deliberately indistinguishable.



## OpenAPI

````yaml api-reference/openapi.account.json GET /pull-requests/{pullRequestID}/github/pr
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:
  /pull-requests/{pullRequestID}/github/pr:
    get:
      tags:
        - pull-requests
      summary: Get a pull request's merge box and live checks
      description: >-
        The merge box comes from the pull request mirror; ci_status and the
        check counts come from the same live GitHub fetch as the checks list, so
        both halves of one response agree even while webhooks lag. Requires
        membership in the owning organization of a task linked to this pull
        request — the task that published it or a task that reviewed it — and
        current GitHub access to the repository. 404 covers an unknown pull
        request, one linked to no organization the caller belongs to, and one
        whose GitHub access the caller has lost; the three are deliberately
        indistinguishable.
      operationId: getPullRequestGithubPR
      parameters:
        - in: path
          name: pullRequestID
          required: true
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  checks:
                    items:
                      $ref: '#/components/schemas/TaskGitHubPullRequestCheck'
                    type: array
                  merge_box:
                    $ref: '#/components/schemas/TaskGitHubPullRequestMergeBox'
                required:
                  - merge_box
                  - checks
                type: object
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/ErrorResponse'
                  - $ref: '#/components/schemas/OrgAuthorizationErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not Found
        '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
        '502':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad Gateway
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Service Unavailable
components:
  schemas:
    TaskGitHubPullRequestCheck:
      additionalProperties: false
      properties:
        check_run_id:
          format: int64
          maximum: 9007199254740991
          minimum: 0
          type: integer
        conclusion:
          minLength: 1
          type: string
        details_url:
          minLength: 1
          type: string
        name:
          type: string
        status:
          minLength: 1
          type: string
        summary:
          type: string
        summary_truncated:
          type: boolean
      required:
        - check_run_id
        - name
        - status
        - summary_truncated
      type: object
    TaskGitHubPullRequestMergeBox:
      additionalProperties: false
      properties:
        additions:
          format: int64
          minimum: 0
          type: integer
        base_branch:
          minLength: 1
          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'
        deletions:
          format: int64
          minimum: 0
          type: integer
        head_branch:
          minLength: 1
          type: string
        head_sha:
          minLength: 1
          type: string
        html_url:
          minLength: 1
          type: string
        mergeable_state:
          $ref: '#/components/schemas/TaskGitHubPRMergeableState'
        pr_number:
          format: int64
          minimum: 1
          type: integer
        state:
          $ref: '#/components/schemas/TaskGitHubPRState'
        title:
          type: string
      required:
        - pr_number
        - title
        - html_url
        - head_sha
        - checks_passed
        - checks_failed
        - checks_total
        - additions
        - deletions
      type: object
    ErrorResponse:
      additionalProperties: false
      properties:
        code:
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
      type: object
    OrgAuthorizationErrorResponse:
      additionalProperties: false
      properties:
        code:
          enum:
            - org_membership_required
            - org_role_insufficient
            - org_suspended
          type: string
        error:
          minLength: 1
          type: string
      required:
        - error
        - code
      type: object
    TaskCIStatus:
      enum:
        - pending
        - passed
        - failed
      type: string
    TaskGitHubPRMergeableState:
      enum:
        - clean
        - dirty
        - blocked
        - behind
        - unstable
        - unknown
        - draft
        - has_hooks
      type: string
    TaskGitHubPRState:
      enum:
        - open
        - closed
        - merged
      type: string
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````