> ## Documentation Index > Fetch the complete documentation index at: https://docs.rainbrand.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a Review > Read a Review's progress and completed findings. This feature is in beta. During beta, endpoint schemas and behavior may change or be removed. ## OpenAPI ````yaml https://www.rainbrand.com/api/v1/spec.json get /reviews/{id} openapi: 3.1.1 info: title: Rainbrand API version: 1.0.0 servers: - url: https://www.rainbrand.com/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Uploads description: >- Stage private local files for brand sources, the Library, and other supported operations. - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Library description: Add, list, and remove a brand's images, video, and audio. - name: Images description: Retrieve and manage images. - name: Videos description: Retrieve and manage video files. - name: Audio description: Retrieve and manage audio files. - name: Briefs description: Get brand guidance and selected assets for a specific task. - name: Models description: Find available models and check their inputs. - name: Generations description: Create and retrieve model generations. - name: Reviews description: >- Check an asset against a brand's color, typography, logo, and copy guidance. paths: /reviews/{id}: get: tags: - Reviews summary: Get a Review description: Read a Review's progress and completed findings. operationId: reviews.get parameters: - name: id in: path required: true schema: type: string format: uuid description: Review ID. - name: wait in: query schema: anyOf: - type: boolean - enum: - '0' - '1' - 'true' - 'false' type: string default: false description: Hold the connection until the resource reaches a terminal status allowEmptyValue: true allowReserved: true - name: timeout in: query schema: type: integer minimum: 1 maximum: 295 default: 120 description: Max seconds to wait (default 120, max 295) allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: data: type: object properties: id: type: string format: uuid description: Review ID. status: enum: - pending - processing - completed - failed type: string description: >- pending means queued; processing means running; completed has results; failed has error details. createdAt: type: string format: date-time description: When the review was created. results: type: object properties: color: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: >- Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply. note: type: string description: >- The reason for the verdict, in 25 words or fewer. evidence: type: array items: type: object properties: url: type: string format: uri description: >- Signed PNG link, valid for seven days. Get the review again for a fresh link. expiresAt: type: string format: date-time description: >- When the signed link expires, as an ISO date and time. required: - url - expiresAt description: >- Pictures supporting the verdict. Empty when the verdict is not_applicable. required: - verdict - note - evidence typography: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: >- Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply. note: type: string description: >- The reason for the verdict, in 25 words or fewer. evidence: type: array items: type: object properties: url: type: string format: uri description: >- Signed PNG link, valid for seven days. Get the review again for a fresh link. expiresAt: type: string format: date-time description: >- When the signed link expires, as an ISO date and time. required: - url - expiresAt description: >- Pictures supporting the verdict. Empty when the verdict is not_applicable. required: - verdict - note - evidence logo: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: >- Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply. note: type: string description: >- The reason for the verdict, in 25 words or fewer. evidence: type: array items: type: object properties: url: type: string format: uri description: >- Signed PNG link, valid for seven days. Get the review again for a fresh link. expiresAt: type: string format: date-time description: >- When the signed link expires, as an ISO date and time. required: - url - expiresAt description: >- Pictures supporting the verdict. Empty when the verdict is not_applicable. required: - verdict - note - evidence copy: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: >- Whether the asset meets the brand guidance: pass, fail, uncertain when evidence is insufficient, or not_applicable when the check does not apply. note: type: string description: >- The reason for the verdict, in 25 words or fewer. evidence: type: array items: type: object properties: url: type: string format: uri description: >- Signed PNG link, valid for seven days. Get the review again for a fresh link. expiresAt: type: string format: date-time description: >- When the signed link expires, as an ISO date and time. required: - url - expiresAt description: >- Pictures supporting the verdict. Empty when the verdict is not_applicable. required: - verdict - note - evidence description: >- 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. completedAt: type: string format: date-time description: >- When the review completed. Present only when status is completed. error: type: object properties: code: type: string description: >- Failure code for handling the error in your application. message: type: string description: A description of what went wrong. retryable: type: boolean description: >- Whether creating a new review may succeed. Retry with a new POST without reusing the previous Idempotency-Key. required: - code - message - retryable description: Failure details. Present only when status is failed. failedAt: type: string format: date-time description: >- When the review failed. Present only when status is failed. required: - id - status - createdAt required: - data examples: - data: id: 657bcf79-1f2f-47fa-90f8-9245142980ed status: completed createdAt: '2026-10-01T12:00:00.000Z' completedAt: '2026-10-01T12:00:45.000Z' results: color: verdict: pass note: >- The background and accent colors match the brand palette. evidence: - url: >- https://storage.example.com/evidence/color.png?token=example expiresAt: '2026-10-08T12:00:45.000Z' '401': description: '401' content: application/json: schema: $ref: '#/components/schemas/ReviewsGet401ErrorResponse' '403': description: '403' content: application/json: schema: $ref: '#/components/schemas/ReviewsGet403ErrorResponse' '404': description: '404' content: application/json: schema: $ref: '#/components/schemas/ReviewsGet404ErrorResponse' '429': description: '429' content: application/json: schema: $ref: '#/components/schemas/ReviewsGet429ErrorResponse' headers: Retry-After: description: >- Seconds until the applicable request or operation limit resets. Present when the limiter can calculate the delay. schema: type: integer minimum: 0 components: schemas: ReviewsGet401ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: UNAUTHORIZED status: const: 401 message: type: string default: Invalid or missing API credentials data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ReviewsGet403ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: ACCOUNT_BANNED status: const: 403 message: type: string default: This account has been suspended. data: {} required: - code - status - message - type: object properties: code: const: FORBIDDEN status: const: 403 message: type: string default: Plan upgrade required data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ReviewsGet404ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: REVIEW_NOT_FOUND status: const: 404 message: type: string default: Review not found. data: {} required: - code - status - message - type: object properties: code: const: BRAND_NOT_FOUND status: const: 404 message: type: string default: Brand not found. data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ReviewsGet429ErrorResponse: type: object properties: error: allOf: - $ref: '#/components/schemas/ApiError' - anyOf: - type: object properties: code: const: TOO_MANY_REQUESTS status: const: 429 message: type: string default: Rate limit exceeded data: {} required: - code - status - message - type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message required: - error ApiError: type: object properties: code: type: string status: type: integer message: type: string data: {} required: - code - status - message securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: 'Rainbrand API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: >- Rainbrand API key (`Bearer bloom_sk_...`) or Rainbrand OAuth access token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.