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

# Changes to List containers

`GET /containers/json`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 79 revisions.

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

## Changes

- **2026-02-24** `6df97b60796c`: 1 breaking, 3 info
  - removed the media type `application/json` for the response with the status `200`
  - api tag `Container` added
  - added the non-success response with the status `400`
  - added the non-success response with the status `500`
- **2026-02-14** `31f80d10d31a`: 7 breaking, 8 warning, 5 info
  - for the `query` request parameter `all`, default value `false` was removed
  - for the `query` request parameter `size`, default value `false` was removed
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
  - the response property `items/ImageManifestDescriptor` became nullable for the status `200`
  - the `items/Id` response property's maxLength was unset from `64` for the response status `200`
  - the `items/Id` response property's minLength was decreased from `64` to `0` for the response status `200`
  - the `items/Ports/items/IP` response's property format changed from `ip-address` to no format for status `200`
  - removed the optional property `items/ImageManifestDescriptor/annotations` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/artifactType` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/data` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/digest` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/mediaType` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/platform` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/size` from the response with the `200` status
  - removed the optional property `items/ImageManifestDescriptor/urls` from the response with the `200` status
  - api tag `Container` removed
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `500`
  - added `#/components/schemas/OCIDescriptor` to the `items/ImageManifestDescriptor` response property `allOf` list for the response status `200`
  - the `items/Id` response's property pattern `^[0-9a-fA-F]{64}$` was removed for the status `200`
- **2026-02-09** `831637d06c77`: 3 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 `400`
  - added the media type `application/json` for the response with the status `500`

---

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