> ## 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 a pull request's recorded verification events

> Every fact recorded against the pull request, newest first, plus the mirror's current head to compare each event's head_sha against — an event whose head does not match current_head_sha was recorded against a commit this pull request has since moved past. current_head_sha is absent only when the mirror has not observed a head yet. 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}/verification-events
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}/verification-events:
    get:
      tags:
        - pull-requests
      summary: List a pull request's recorded verification events
      description: >-
        Every fact recorded against the pull request, newest first, plus the
        mirror's current head to compare each event's head_sha against — an
        event whose head does not match current_head_sha was recorded against a
        commit this pull request has since moved past. current_head_sha is
        absent only when the mirror has not observed a head yet. 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: listPullRequestVerificationEvents
      parameters:
        - in: path
          name: pullRequestID
          required: true
          schema:
            format: uuid
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PullRequestVerificationEventsResponse'
          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:
    PullRequestVerificationEventsResponse:
      additionalProperties: false
      properties:
        current_head_sha:
          pattern: ^[0-9a-f]{40}$
          type: string
        events:
          items:
            $ref: '#/components/schemas/PRVerificationEvent'
          type: array
      required:
        - events
      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
    PRVerificationEvent:
      additionalProperties: false
      properties:
        actor:
          enum:
            - author_agent
            - reviewer_agent
          type: string
        command:
          minLength: 1
          type: string
        created_at:
          format: date-time
          type: string
        exit_status:
          format: int64
          type: integer
        head_sha:
          pattern: ^[0-9a-f]{40}$
          type: string
        id:
          format: uuid
          type: string
        kind:
          enum:
            - tests
            - typecheck
            - lint
            - browser_check
            - preview_session
          type: string
        output_ref:
          type: string
        summary:
          minLength: 1
          type: string
        task_id:
          format: uuid
          type: string
      required:
        - id
        - head_sha
        - actor
        - kind
        - command
        - summary
        - created_at
      type: object
    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
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT
      scheme: bearer
      type: http

````