---
title: "List a worker's code-review runs"
method: GET
path: "/api/v1/sessions/{sessionId}/reviews"
tags: ["reviews"]
---

# List a worker's code-review runs

`GET /api/v1/sessions/{sessionId}/reviews`

## Path parameters

- `sessionId` string, required — Session identifier, e.g. project-1.

## Response `200`

OK

- ListReviewsResponse
  - `reviewerActivityState` 'active' | 'idle' | 'waiting_input' | 'blocked' | 'exited'
  - `reviewerHandleId` string, required
  - `reviewerHarness` string
  - `reviewerSurface` DomainReviewerSurface
    - `controllerError` string
    - `handleId` string
    - `harness` string, required
    - `mode` string, required
    - `reviewId` string, required
  - `reviews` PRReviewState[], required
    - `latestRun` ReviewRun
      - `autoInjectReview` boolean, required
      - `batchId` string, required
      - `body` string, required
      - `createdAt` string, date-time, required
      - `deliveredAt` string, date-time, nullable
      - `githubReviewId` string, required
      - `harness` string, required
      - `id` string, required
      - `prUrl` string, required
      - `reviewId` string, required
      - `sessionId` string, required
      - `status` string, required
      - `targetSha` string, required
      - `triggerSource` 'manual' | 'auto', required
      - `verdict` string, required
    - `prNumber` integer, required
    - `prUrl` string, required
    - `previousRun` ReviewRun
      - `autoInjectReview` boolean, required
      - `batchId` string, required
      - `body` string, required
      - `createdAt` string, date-time, required
      - `deliveredAt` string, date-time, nullable
      - `githubReviewId` string, required
      - `harness` string, required
      - `id` string, required
      - `prUrl` string, required
      - `reviewId` string, required
      - `sessionId` string, required
      - `status` string, required
      - `targetSha` string, required
      - `triggerSource` 'manual' | 'auto', required
      - `verdict` string, required
    - `status` 'needs_review' | 'running' | 'up_to_date' | 'changes_requested' | 'ineligible', required
    - `targetSha` string, required
    - `title` string, required
  - `runs` ReviewRun[], required
    - `autoInjectReview` boolean, required
    - `batchId` string, required
    - `body` string, required
    - `createdAt` string, date-time, required
    - `deliveredAt` string, date-time, nullable
    - `githubReviewId` string, required
    - `harness` string, required
    - `id` string, required
    - `prUrl` string, required
    - `reviewId` string, required
    - `sessionId` string, required
    - `status` string, required
    - `targetSha` string, required
    - `triggerSource` 'manual' | 'auto', required
    - `verdict` string, required

## Other responses

- `422` — Unprocessable Entity
- `501` — Not Implemented

## Changes

- **2026-09-22** `20e51aca854f` — 1 info
  - added the optional property `reviewerSurface` to the response with the `200` status
- **2026-09-11** `c7ee9e7822eb` — 1 info
  - added the optional property `reviewerActivityState` to the response with the `200` status
- **2026-09-03** `d31a2d019c47` — 2 info
  - added the optional property `reporting_owner` to the response with the `422` status
  - added the optional property `reporting_owner` to the response with the `501` status
- **2026-08-13** `71905b90713b` — 3 info
  - added the required property `reviews/items/latestRun/triggerSource` to the response with the `200` status
  - added the required property `reviews/items/previousRun/triggerSource` to the response with the `200` status
  - added the required property `runs/items/triggerSource` to the response with the `200` status
- **2026-08-09** `be069344383f` — 3 info
  - added the required property `reviews/items/latestRun/autoInjectReview` to the response with the `200` status
  - added the required property `reviews/items/previousRun/autoInjectReview` to the response with the `200` status
  - added the required property `runs/items/autoInjectReview` to the response with the `200` status

[Full history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/:sessionId/reviews/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) · [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) · [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/401b2f38894f?raw)