---
title: "Get a Review"
method: GET
path: "/reviews/{id}"
tags: ["Reviews"]
---

# Get a Review

`GET /reviews/{id}`

## Request

- Base URL: `https://www.rainbrand.com/api/v1`
- URL: `https://www.rainbrand.com/api/v1/reviews/{id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://www.rainbrand.com/api/auth/oauth2/authorize`
    - Token URL: `https://www.rainbrand.com/api/auth/oauth2/token`

Read a Review's progress and completed findings.

## Path parameters

- `id` string, uuid, required: Review ID.

## Query parameters

- `wait` union: Hold the connection until the resource reaches a terminal status
  - boolean
  - '0' | '1' | 'true' | 'false'
- `timeout` integer: Max seconds to wait (default 120, max 295)

## Response `200`

OK

- object
  - `data` object, required
    - `warnings` object[]: Nonfatal evidence-image problems on a completed Review. Verdicts and notes remain available; unavailable image links are omitted.
      - `code` 'evidence_images_unavailable', required
      - `message` 'Some evidence images couldn’t be saved', required
    - `id` string, uuid, required: Review ID.
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required: pending means queued; processing means running; completed has results; failed has error details.
    - `createdAt` string, date-time, required: When the review was created.
    - `results` object: Each result includes a verdict, a short reason, and evidence images showing what was measured or compared, where available. Results are present only when status is completed. Evidence can include multiple images and is empty when the verdict is not_applicable.
      - `color` object
        - `verdict` 'pass' | 'fail' | 'uncertain' | 'not_applicable', required: Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply.
        - `note` string, required: The reason for the verdict, in 25 words or fewer.
        - `evidence` object[], required: Pictures supporting the verdict. Empty when the verdict is not_applicable.
          - `url` string, uri, required: Signed PNG link, valid for seven days. Get the review again for a fresh link.
          - `expiresAt` string, date-time, required: When the signed link expires, as an ISO date and time.
      - `typography` object
        - `verdict` 'pass' | 'fail' | 'uncertain' | 'not_applicable', required: Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply.
        - `note` string, required: The reason for the verdict, in 25 words or fewer.
        - `evidence` object[], required: Pictures supporting the verdict. Empty when the verdict is not_applicable.
          - `url` string, uri, required: Signed PNG link, valid for seven days. Get the review again for a fresh link.
          - `expiresAt` string, date-time, required: When the signed link expires, as an ISO date and time.
      - `logo` object
        - `verdict` 'pass' | 'fail' | 'uncertain' | 'not_applicable', required: Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply.
        - `note` string, required: The reason for the verdict, in 25 words or fewer.
        - `evidence` object[], required: Pictures supporting the verdict. Empty when the verdict is not_applicable.
          - `url` string, uri, required: Signed PNG link, valid for seven days. Get the review again for a fresh link.
          - `expiresAt` string, date-time, required: When the signed link expires, as an ISO date and time.
      - `copy` object
        - `verdict` 'pass' | 'fail' | 'uncertain' | 'not_applicable', required: Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply.
        - `note` string, required: The reason for the verdict, in 25 words or fewer.
        - `evidence` object[], required: Pictures supporting the verdict. Empty when the verdict is not_applicable.
          - `url` string, uri, required: Signed PNG link, valid for seven days. Get the review again for a fresh link.
          - `expiresAt` string, date-time, required: When the signed link expires, as an ISO date and time.
    - `completedAt` string, date-time: When the review completed. Present only when status is completed.
    - `error` object: Failure details. Present only when status is failed.
      - `code` string, required: Failure code for handling the error in your application.
      - `message` string, required: A description of what went wrong.
      - `retryable` boolean, required: Whether creating a new review may succeed. Retry with a new POST without reusing the previous Idempotency-Key.
    - `failedAt` string, date-time: When the review failed. Present only when status is failed.

## Other responses

- `401`: 401
- `403`: 403
- `404`: 404
- `429`: 429

## Changes

- **2026-11-02** `012b8e9da4df`: 1 info
  - added the optional property `data/warnings` to the response with the `200` status

[Operation history](https://skmtc.dev/rainbrand/apis/rainbrand-api/changes/reviews/:id/get.md)

---

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