---
title: "Round"
method: GET
path: "/api/v1/reviews/rounds/{requestId}"
tags: ["reviews"]
---

# Round

`GET /api/v1/reviews/rounds/{requestId}`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/reviews/rounds/{requestId}`
- Auth: HTTP bearer

## Path parameters

- `requestId` string, required

## Response `200`

ReviewRound

- ReviewRoundEncoded
  - `requestId` string, required
  - `reviewId` string, required
  - `threadId` string, nullable, required
  - `repo` string, required
  - `prNumber` integer, required
  - `headSha` string, required
  - `baseSha` string, required
  - `status` 'pending' | 'running' | 'completed' | 'failed' | 'stale', required
  - `shadow` boolean, required
  - `model` string, nullable, required
  - `effort` 'none' | 'instant' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max', nullable, required
  - `tier` 'low' | 'medium' | 'high', nullable, required
  - `baselineSha` string, nullable, required
  - `title` string, nullable, required
  - `failureReason` string, nullable, required
  - `failureMessage` string, nullable, required
  - `createdAt` string, required
  - `settledAt` string, nullable, required
  - `memory` ReviewRoundMemoryEncoded, required
    - `projectId` string, required
    - `volumeId` string, required
    - `versionId` string, required
  - `memoryReason` 'no_project' | 'several_projects' | 'memory_off' | 'empty', nullable, required
  - `memorySelection` 'index' | 'paths' | 'select', required
  - `memoryTopics` object[], required
    - `path` string, required
    - `title` string, required
  - `findings` ReviewRoundFindingEncoded[], required
    - `id` string, required
    - `ruleId` string, nullable, required
    - `memory` ReviewFindingMemoryEncoded, required
      - `volumeId` string, required
      - `versionId` string, required
      - `path` string, required
      - `title` string, required
    - `telemetry` object, nullable, required
      - `window` string, nullable, required
      - `note` string
    - `kind` 'issue' | 'note', required
    - `severity` 'low' | 'medium' | 'high', nullable, required
    - `confidence` 'confirmed' | 'investigate', nullable, required
    - `category` 'bug' | 'risk' | 'maintainability' | 'refactor', nullable, required
    - `summary` string, required
    - `detail` string, nullable, required
    - `suggestion` string, nullable, required
    - `file` string, nullable, required
    - `line` integer, nullable, required
    - `startLine` integer, nullable, required
    - `files` string[], nullable, required

## Other responses

- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/ReviewRoundNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-18** `6a5749476601`: 1 info
  - added the required property `findings/items/telemetry` to the response with the `200` status
- **2026-10-10** `419850a67cf8`: 1 info
  - added the required property `failureMessage` to the response with the `200` status
- **2026-09-30** `7187d2287ecd`: 2 breaking, 6 info
  - the response's body type changed from `object` to no type for status `403`
  - removed the required property `_tag` from the response with the `403` status
  - added `#/components/schemas/capy_ForbiddenEncoded, #/components/schemas/capy_ForbiddenEncoded` to the response body `anyOf` list for the response status `403`
  - added the required property `findings/items/memory` to the response with the `200` status
  - …4 more
- **2026-09-24** `0de0f8cfab7d`: 1 info
  - added the required property `findings/items/ruleId` to the response with the `200` status
- **2026-09-15** `99829483ed33`: 1 info
  - added the required property `baselineSha` to the response with the `200` status

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/reviews/rounds/:requestId/get.md)

---

[API](https://skmtc.dev/capy/apis/capy-api.md) - [All operations](https://skmtc.dev/capy/apis/capy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capy/apis/capy-api/revisions/4663f7dc4e39?raw)