---
search:
  tags:
    - Images
    - GET
seo:
  description: >-
    Get an image. Reference for the GET /v1/images/{id} endpoint in the Ibby
    API.
sidebar:
  label: Get an image
  badge: GET
title: Get an image
type: openapi-operation
---
`GET /v1/images/{id}`

**Responses**

- `200` — The image.
- `400` — \`invalid\_request\`: The request does not match the contract.
- `401` — \`unauthorized\`: The API key is missing, unknown or revoked.
- `404` — \`not\_found\`: No such resource in this key's lane. Another lane's ids are not found either.
- `409` — \`image\_not\_built\`: The image is not ready. On a create: its build is still running, or it failed; check the image, then create the sandbox again. On getting an image: the image has no build on the lane's current provider; rebuild it. That arises only after a lane changes provider.
- `500` — \`internal\_error\`: The platform failed. A retry may succeed; for a call that creates or writes, retry with the same Idempotency-Key.
- `503` — \`unavailable\`: A service behind the API could not be reached. Retry after a short wait; for a call that creates or writes, with the same Idempotency-Key.

Response example, 200:

```json
{
  "created_at": "2019-08-24T14:15:22Z",
  "id": "img_4Rt8sK",
  "status": "building"
}
```