---
title: "The image a reference names: an id, name (its latest tag), name:tag or name@version."
method: GET
path: "/v1/images/resolve"
tags: ["images"]
---

# The image a reference names: an id, name (its latest tag), name:tag or name@version.

`GET /v1/images/resolve`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/images/resolve`
- Auth: HTTP bearer

## Query parameters

- `ref` string: An image id, a name (its latest tag), name:tag or name@version.

## Response `200`

Success

- object
  - `id` string, required
  - `kind` 'image', required
  - `status` string, required
  - `state` 'queued' | 'building' | 'ready' | 'failed' | 'deleting' | 'deleted', required
  - `name` string, nullable
  - `version` integer, nullable
  - `tags` string[]
  - `sizeBytes` integer, nullable: The image's whole file, once it is ready. Its storage is charged on this.
  - `sizeMiB` integer, nullable
  - `storedBytes` integer, nullable: The part of the file that shares nothing with other files on its server, measured when it was built; often 0, since an image is built on a shared base. Not what it is charged on: sizeBytes is.
  - `error` string, nullable
  - `createdAt` string

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)