---
title: "Get an image's history"
method: GET
path: "/images/{imageid}/history"
---

# Get an image's history

`GET /images/{imageid}/history`

Return the history of each layer of image

## Path parameters

- `imageid` string, required

## Response `200`

no error

- HistoryResultItem[]
  - `ID` string, required — ID of each layer image.
  - `Created` integer, required — the combined date and time at which the layer was created.
  - `CreatedBy` string, required — the command which created the layer.
  - `Author` string, required — the author of the build point.
  - `Comment` string, required — a custom message set when creating the layer.
  - `EmptyLayer` boolean, required — mark whether the history item created a filesystem diff or not.
  - `Size` integer, required — size of each layer image.

## Other responses

- `404` — An unexpected 404 error occurred.
- `500` — An unexpected server error occurred.

## Changes

- **2018-08-14** `d37e71545c5d` — 1 info
  - endpoint added
- **2018-08-03** `5ae9c809fadb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aliyun/apis/pouch-engine-api/changes/images/:imageid/history/get.md)

---

[API](https://skmtc.dev/aliyun/apis/pouch-engine-api.md) · [All operations](https://skmtc.dev/aliyun/apis/pouch-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aliyun/pouch-engine-api/revisions/36d75b2825fc/schema)