# Retrieve an image score

`GET /v1/images/{image_id}/score`

Returns the current scoring state of an image previously sent to
[Submit an image for scoring](/api/images/scoreImage). Poll until
`status` moves from `processing` to `scored`.

Hero images return a `score_metadata` breakdown alongside
`vizit_score`; carousel images return `vizit_score` only.

## Responses

### 200 — Image scoring status

**application/json**

- **object** — Image scoring status. When `status` is `"processing"` or `"error"`,
score fields may be absent. When `status` is `"scored"`, `vizit_score`
is populated and `score_metadata` is populated for hero images.

  - `image_id` (string, required) — Internal identifier for the image. Pass it to [Retrieve an image score](/api/images/getImageScore) to poll for results.
  - `status` (enum: "processing" | "scored" | "error", required)
  - `vizit_score` (any) — Composite image score (0–100). For hero images this is the hero
score; for carousel images this is the carousel `vizit_score`.

  - `conversion_ready` (any) — Whether the image meets the conversion-readiness bar. `null` until
the image is `scored`.

  - `score_metadata` (any) — Hero-image score breakdown. `null` for carousel images.
  - `hero_gs1_components` (any) — Per-component GS1 hero sub-scores. Populated for hero images, `null`
for carousel images.

  - `mobile_readiness` (any) — Hero-image mobile-readiness clarity scores. `null` for carousel images.
  - `classification` (any) — Image classification label (normalized to the canonical vocabulary).

### 401 — Missing or invalid Bearer token

### 404 — Image not found for this id in the caller's organization

**application/json**

- **object** — Standardized error format for all `/v1/*` endpoints. `error_code` is a
stable SCREAMING_SNAKE_CASE identifier clients can switch on.

  - `detail` (string) — Human-readable error message
  - `status_code` (integer) — HTTP status code
  - `error_code` (string) — Stable machine-readable error code
  - `request_id` (any) — Request identifier for correlation
  - `extra` (any) — Endpoint-specific additional context. For example,
IMAGE_DOWNLOAD_FAILED populates extra.failed_urls with per-URL
failure reasons so clients can triage bulk submissions.

  - `timestamp` (string)