---
title: "Changes to List Images"
method: GET
path: "/images/json"
---

# Changes to List Images

`GET /images/json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 79 revisions.

- **2026-02-27** `f86e64e24331`: 1 info
- **2026-02-24** `6df97b60796c`: 1 breaking, 2 info
- **2026-02-14** `31f80d10d31a`: 6 breaking, 8 warning, 3 info
- **2026-02-09** `831637d06c77`: 2 info

## Changes

- **2026-02-27** `f86e64e24331`: 1 info
  - added the new optional `query` request parameter `identity`
- **2026-02-24** `6df97b60796c`: 1 breaking, 2 info
  - removed the media type `application/json` for the response with the status `200`
  - api tag `Image` added
  - added the non-success response with the status `500`
- **2026-02-14** `31f80d10d31a`: 6 breaking, 8 warning, 3 info
  - for the `query` request parameter `all`, default value `false` was removed
  - for the `query` request parameter `digests`, default value `false` was removed
  - for the `query` request parameter `manifests`, default value `false` was removed
  - for the `query` request parameter `shared-size`, default value `false` was removed
  - the response property `items/Descriptor` became nullable for the status `200`
  - the `items/Manifests/items/Descriptor/urls/items/` response's property format changed from `uri` to no format for status `200`
  - removed the optional property `items/Descriptor/annotations` from the response with the `200` status
  - removed the optional property `items/Descriptor/artifactType` from the response with the `200` status
  - removed the optional property `items/Descriptor/data` from the response with the `200` status
  - removed the optional property `items/Descriptor/digest` from the response with the `200` status
  - removed the optional property `items/Descriptor/mediaType` from the response with the `200` status
  - removed the optional property `items/Descriptor/platform` from the response with the `200` status
  - removed the optional property `items/Descriptor/size` from the response with the `200` status
  - removed the optional property `items/Descriptor/urls` from the response with the `200` status
  - api tag `Image` removed
  - removed the non-success response with the status `500`
  - added `#/components/schemas/OCIDescriptor` to the `items/Descriptor` response property `allOf` list for the response status `200`
- **2026-02-09** `831637d06c77`: 2 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `500`

---

[Operation](https://skmtc.dev/hexlet/apis/docker-engine-api/docs/images/json/get.md) - [API](https://skmtc.dev/hexlet/apis/docker-engine-api.md) - [Page](https://skmtc.dev/hexlet/apis/docker-engine-api/changes/images/json/get)