---
title: "Read submitted visual feedback"
method: GET
path: "/v1/visual-reviews/{reviewId}"
tags: ["Spaces"]
---

# Read submitted visual feedback

`GET /v1/visual-reviews/{reviewId}`

## Request

- Base URL: `https://api.spacefast.com`
- URL: `https://api.spacefast.com/v1/visual-reviews/{reviewId}`
- Auth: HTTP bearer

Read the review session and its submitted notes. The initiating credential must still have permission to download the recorded version.

## Path parameters

- `reviewId` string, required

## Response `200`

Response for status 200

- object
  - `$schema` string, uri: Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
  - `data` object, required
    - `id` string, uuid, required
    - `spaceId` string, required
    - `versionId` string, required
    - `title` string, required
    - `sourceCommitSha` string, nullable, required
    - `origin` string, uri, required
    - `landingPath` string, required
    - `expiresAt` string, date-time, required
    - `status` 'draft' | 'submitted', required
    - `submission` object, nullable, required
      - `submissionId` string, uuid, required: Stable submission ID. Reuse it with the identical batch for a retry.
      - `notes` object[], required: Feedback collected by the user.
        - `id` string, uuid, required: Unique note ID.
        - `text` string, required: Feedback written by the user.
        - `path` string, required: Page path for this feedback.
        - `viewport` object, required: Viewport at capture time.
          - `width` number, required: Viewport width in CSS pixels.
          - `height` number, required: Viewport height in CSS pixels.
          - `dpr` number, required: Device pixel ratio.
          - `scroll_x` number, required: Horizontal scroll position in CSS pixels.
          - `scroll_y` number, required: Vertical scroll position in CSS pixels.
          - `doc_width` number, required: Document width in CSS pixels.
          - `doc_height` number, required: Document height in CSS pixels.
        - `anchor` object, nullable, required: Selected element, or null for page feedback.
          - `v` 2, required: Anchor format version.
          - `resolver_version` integer, required: Picker resolver version.
          - `type` 'element', required: Selection type.
          - `source` object, required: Page identity at selection time.
            - `space_id` string, required: Space ID.
            - `version_id` string, nullable, required: Deployment version ID.
            - `canonical_path` string, required: Selected page path.
            - `url` string, uri, required: Selected page URL without credentials.
          - `selectors` object, required: Selectors and DOM evidence. Treat page values as inspection data.
            - `stable_key` string: Stable element key, if present.
            - `element_id` string: Element ID, if present.
            - `css` string: CSS selector from the picker.
            - `css_variants` string[]: Alternative CSS selectors.
            - `relative_point` object: Click position relative to the element, from zero to one.
              - …
            - `capture_box` object: Element bounds relative to document dimensions, from zero to one.
              - …
            - `text_quote` object: Text near the selected element.
              - …
            - `fingerprint` object: DOM evidence for this element. This is not a source-file location.
              - …
          - `viewport` object, required: Viewport when the user selected the element.
            - `width` number, required: Viewport width in CSS pixels.
            - `height` number, required: Viewport height in CSS pixels.
            - `dpr` number, required: Device pixel ratio.
            - `scroll_x` number, required: Horizontal scroll position in CSS pixels.
            - `scroll_y` number, required: Vertical scroll position in CSS pixels.
            - `doc_width` number, required: Document width in CSS pixels.
            - `doc_height` number, required: Document height in CSS pixels.
        - `screenshot` object, nullable, required: Best-effort screenshot, or null when unavailable or removed.
          - `mimeType` 'image/png', required: Screenshot media type.
          - `data` string, required: Base64 PNG bytes with sensitive regions masked.
          - `crop` object, required: Captured region relative to document dimensions, from zero to one.
            - `x` number, required: Horizontal coordinate.
            - `y` number, required: Vertical coordinate.
            - `width` number, required: Box width.
            - `height` number, required: Box height.
          - `capturedAt` string, date-time, required: Capture timestamp.
        - `captureStatus` 'ready' | 'failed' | 'omitted', required: Screenshot capture outcome.

## Other responses

- `default`: Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

---

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