> ## Documentation Index > Fetch the complete documentation index at: https://docs.trybloom.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get a review > Get a review's status and, once completed, a verdict, note, and evidence pictures for each requested check. Set wait=true to wait until it completes or fails. The timeout covers the whole request; if the review is still pending or processing, repeat the same request. Only the review's creator can read it. Reviews are in private beta for selected accounts. To request access, contact [support@trybloom.ai](mailto:support@trybloom.ai). ## OpenAPI ````yaml https://www.trybloom.ai/api/v1/spec.json get /reviews/{id} openapi: 3.1.1 info: title: Bloom API version: 1.0.0 servers: - url: https://www.trybloom.ai/api/v1 security: - apiKey: [] - bearer: [] tags: - name: Account description: >- Inspect the authenticated account — profile, credit balance, and accessible workspaces. - name: Brands description: Manage brands and brand identity. - name: Images description: Generate, edit, and retrieve images. - name: Models description: Find available models and check their inputs. - name: Generations description: Generate images, video, audio, and SVG, then retrieve the results. - name: Reviews description: >- Check an asset against a brand's color, typography, logo, and copy guidance. - name: Uploads description: >- Stage private local files for Brand sources, Library images, and other supported operations. paths: /reviews/{id}: get: tags: - Reviews summary: Get a review description: >- Get a review's status and, once completed, a verdict, note, and evidence pictures for each requested check. Set wait=true to wait until it completes or fails. The timeout covers the whole request; if the review is still pending or processing, repeat the same request. Only the review's creator can read it. 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: anyOf: - type: object properties: id: type: string format: uuid description: Review ID. status: const: pending createdAt: type: string format: date-time description: When the review was created. brandSessionId: type: string format: uuid description: Brand the review judged against. skillId: anyOf: - type: string format: uuid - type: 'null' description: >- Brand Skill version the review judged against; null once that version is deleted. assets: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: What Bloom reviewed. references: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: References sent with the request. context: anyOf: - type: string - type: 'null' description: Context sent with the request. required: - id - status - createdAt - brandSessionId - skillId - assets - references - context - type: object properties: id: type: string format: uuid description: Review ID. status: const: processing createdAt: type: string format: date-time description: When the review was created. brandSessionId: type: string format: uuid description: Brand the review judged against. skillId: anyOf: - type: string format: uuid - type: 'null' description: >- Brand Skill version the review judged against; null once that version is deleted. assets: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: What Bloom reviewed. references: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: References sent with the request. context: anyOf: - type: string - type: 'null' description: Context sent with the request. required: - id - status - createdAt - brandSessionId - skillId - assets - references - context - type: object properties: id: type: string format: uuid description: Review ID. status: const: completed createdAt: type: string format: date-time description: When the review was created. completedAt: type: string format: date-time description: When the review completed. brandSessionId: type: string format: uuid description: Brand the review judged against. skillId: anyOf: - type: string format: uuid - type: 'null' description: >- Brand Skill version the review judged against; null once that version is deleted. assets: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: What Bloom reviewed. references: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: References sent with the request. context: anyOf: - type: string - type: 'null' description: Context sent with the request. checks: type: object properties: color: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: The call for this check. note: type: string description: Plain-language reason, 25 words or fewer. evidence: type: array items: type: object properties: kind: enum: - color - font - logo - text - view type: string description: >- What the picture shows: a color, font, logo, or text measurement, or a view of the asset, whole or zoomed in. location: type: object properties: asset: type: integer minimum: 0 maximum: 9007199254740991 description: >- Index of the asset in the request's assets list. box: type: array minItems: 4 maxItems: 4 items: type: number description: >- [ymin, xmin, ymax, xmax] on a 0-1000 scale. required: - asset - box description: >- Where in the asset the picture was measured. picture: type: object properties: url: type: string format: uri description: Signed link to the evidence picture. mimeType: const: image/png expiresAt: type: string format: date-time description: When the link stops working. required: - url - mimeType - expiresAt required: - kind - location - picture description: >- A picture that shows why the verdict was reached. required: - verdict - note - evidence typography: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: The call for this check. note: type: string description: Plain-language reason, 25 words or fewer. evidence: type: array items: type: object properties: kind: enum: - color - font - logo - text - view type: string description: >- What the picture shows: a color, font, logo, or text measurement, or a view of the asset, whole or zoomed in. location: type: object properties: asset: type: integer minimum: 0 maximum: 9007199254740991 description: >- Index of the asset in the request's assets list. box: type: array minItems: 4 maxItems: 4 items: type: number description: >- [ymin, xmin, ymax, xmax] on a 0-1000 scale. required: - asset - box description: >- Where in the asset the picture was measured. picture: type: object properties: url: type: string format: uri description: Signed link to the evidence picture. mimeType: const: image/png expiresAt: type: string format: date-time description: When the link stops working. required: - url - mimeType - expiresAt required: - kind - location - picture description: >- A picture that shows why the verdict was reached. required: - verdict - note - evidence logo: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: The call for this check. note: type: string description: Plain-language reason, 25 words or fewer. evidence: type: array items: type: object properties: kind: enum: - color - font - logo - text - view type: string description: >- What the picture shows: a color, font, logo, or text measurement, or a view of the asset, whole or zoomed in. location: type: object properties: asset: type: integer minimum: 0 maximum: 9007199254740991 description: >- Index of the asset in the request's assets list. box: type: array minItems: 4 maxItems: 4 items: type: number description: >- [ymin, xmin, ymax, xmax] on a 0-1000 scale. required: - asset - box description: >- Where in the asset the picture was measured. picture: type: object properties: url: type: string format: uri description: Signed link to the evidence picture. mimeType: const: image/png expiresAt: type: string format: date-time description: When the link stops working. required: - url - mimeType - expiresAt required: - kind - location - picture description: >- A picture that shows why the verdict was reached. required: - verdict - note - evidence copy: type: object properties: verdict: enum: - pass - fail - uncertain - not_applicable type: string description: The call for this check. note: type: string description: Plain-language reason, 25 words or fewer. evidence: type: array items: type: object properties: kind: enum: - color - font - logo - text - view type: string description: >- What the picture shows: a color, font, logo, or text measurement, or a view of the asset, whole or zoomed in. location: type: object properties: asset: type: integer minimum: 0 maximum: 9007199254740991 description: >- Index of the asset in the request's assets list. box: type: array minItems: 4 maxItems: 4 items: type: number description: >- [ymin, xmin, ymax, xmax] on a 0-1000 scale. required: - asset - box description: >- Where in the asset the picture was measured. picture: type: object properties: url: type: string format: uri description: Signed link to the evidence picture. mimeType: const: image/png expiresAt: type: string format: date-time description: When the link stops working. required: - url - mimeType - expiresAt required: - kind - location - picture description: >- A picture that shows why the verdict was reached. required: - verdict - note - evidence description: One result for each requested check. required: - id - status - createdAt - completedAt - brandSessionId - skillId - assets - references - context - checks - type: object properties: id: type: string format: uuid description: Review ID. status: const: failed createdAt: type: string format: date-time description: When the review was created. failedAt: type: string format: date-time description: When the review failed. brandSessionId: type: string format: uuid description: Brand the review judged against. skillId: anyOf: - type: string format: uuid - type: 'null' description: >- Brand Skill version the review judged against; null once that version is deleted. assets: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: What Bloom reviewed. references: type: array items: anyOf: - type: object properties: kind: const: image imageId: type: string format: uuid required: - kind - imageId - type: object properties: kind: const: file mediaType: type: string description: Media type Bloom read from the bytes. filename: type: string byteLength: type: integer minimum: -9007199254740991 maximum: 9007199254740991 exclusiveMinimum: 0 required: - kind - mediaType - filename - byteLength description: References sent with the request. context: anyOf: - type: string - type: 'null' description: Context sent with the request. error: type: object properties: code: type: string description: Machine-readable failure code. message: type: string retryable: type: boolean description: Whether creating a new review may succeed. required: - code - message - retryable required: - id - status - createdAt - failedAt - brandSessionId - skillId - assets - references - context - error required: - data '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 API-key request limit resets. Present only when the request-rate 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: 'Bloom API key, for example `x-api-key: bloom_sk_...`.' bearer: type: http scheme: bearer description: Bloom API key (`Bearer bloom_sk_...`) or Bloom OAuth access token. ````