Docker Engine API
  1. Image
Docker Engine API
  • System
    • Ping
      GET
    • Check auth configuration
      POST
    • Monitor events
      GET
    • Get system information
      GET
    • Get data usage information
      GET
    • Get version
      GET
  • Image
    • Build an image
      POST
    • Delete builder cache
      POST
    • Create a new image from a container
      POST
    • Create an image
      POST
    • Export several images
      GET
    • List Images
      GET
    • Import images
      POST
    • Delete unused images
      POST
    • Search images
      GET
    • Remove an image
      DELETE
    • Export an image
      GET
    • Get the history of an image
      GET
    • Inspect an image
      GET
    • Push an image
      POST
    • Tag an image
      POST
  • Config
    • List configs
      GET
    • Create a config
      POST
    • Delete a config
      DELETE
    • Inspect a config
      GET
    • Update a Config
      POST
  • Container
    • Create a container
    • List containers
    • Delete stopped containers
    • Remove a container
    • Get an archive of a filesystem resource in a container
    • Get information about files in a container
    • Extract an archive of files or folders to a directory in a container
    • Attach to a container
    • Attach to a container via a websocket
    • Get changes on a container’s filesystem
    • Export a container
    • Inspect a container
    • Kill a container
    • Get container logs
    • Pause a container
    • Rename a container
    • Resize a container TTY
    • Restart a container
    • Start a container
    • Get container stats based on resource usage
    • Stop a container
    • List processes running inside a container
    • Unpause a container
    • Update a container
    • Wait for a container
  • Exec
    • Create an exec instance
    • Inspect an exec instance
    • Resize an exec instance
    • Start an exec instance
  • Distribution
    • Get image information from the registry
  • Network
    • List networks
    • Create a network
    • Delete unused networks
    • Remove a network
    • Inspect a network
    • Connect a container to a network
    • Disconnect a container from a network
  • Node
    • List nodes
    • Delete a node
    • Inspect a node
    • Update a node
  • Plugin
    • List plugins
    • Create a plugin
    • Get plugin privileges
    • Install a plugin
    • Remove a plugin
    • Disable a plugin
    • Enable a plugin
    • Inspect a plugin
    • Push a plugin
    • Configure a plugin
    • Upgrade a plugin
  • Secret
    • List secrets
    • Create a secret
    • Delete a secret
    • Inspect a secret
    • Update a Secret
  • Service
    • List services
    • Create a service
    • Delete a service
    • Inspect a service
    • Get service logs
    • Update a service
  • Session (experimental)
    • Initialize interactive session
  • Swarm
    • Inspect swarm
    • Initialize a new swarm
    • Join an existing swarm
    • Leave a swarm
    • Unlock a locked manager
    • Get the unlock key
    • Update a swarm
  • Task
    • List tasks
    • Inspect a task
  • Volume
    • List volumes
    • Create a volume
    • Delete unused volumes
    • Remove a volume
    • Inspect a volume
  • Get task logs
    GET
  1. Image

List Images

/v1.33
/v1.33
/v1.33
/v1.33
GET
/images/json
Image
Returns a list of images on the server. Note that it uses a different, smaller representation of an image than inspecting a single image.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.33/images/json'
Response Response Example
200 - response
[
    {
        "Containers": 2,
        "Created": 1474925151,
        "Id": "sha256:e216a057b1cb1efc11f8a268f37ef62083e70b1b38323ba252e25ac88904a7e8",
        "Labels": {},
        "ParentId": "",
        "RepoDigests": [
            "ubuntu@sha256:992069aee4016783df6345315302fa59681aae51a8eeb2f889dea59290f21787"
        ],
        "RepoTags": [
            "ubuntu:12.04",
            "ubuntu:precise"
        ],
        "SharedSize": 0,
        "Size": 103579269,
        "VirtualSize": 103579269
    },
    {
        "Containers": 5,
        "Created": 1403128455,
        "Id": "sha256:3e314f95dcace0f5e4fd37b10862fe8398e3c60ed36600bc0ca5fda78b087175",
        "Labels": {},
        "ParentId": "",
        "RepoDigests": [
            "ubuntu@sha256:002fba3e3255af10be97ea26e476692a7ebed0bb074a9ab960b2e7a1526b15d7",
            "ubuntu@sha256:68ea0200f0b90df725d99d823905b04cf844f6039ef60c60bf3e019915017bd3"
        ],
        "RepoTags": [
            "ubuntu:12.10",
            "ubuntu:quantal"
        ],
        "SharedSize": 0,
        "Size": 172064416,
        "VirtualSize": 172064416
    }
]

Request

Query Params
all
string 
optional
Show all images. Only images from a final layer (no children) are shown by default.
filters
string 
optional
A JSON encoded value of the filters (a map[string][]string) to process on the images list. Available filters:
before=(<image-name>[:<tag>], <image id> or <image@digest>)
dangling=true
label=key or label="key=value" of an image label
reference=(<image-name>[:<tag>])
since=(<image-name>[:<tag>], <image id> or <image@digest>)
digests
string 
optional
Show digest information as a RepoDigests field on each image.

Responses

🟢200Summary image data for the images matching the query
application/json
Body
array of:
Containers
integer 
required
Created
integer 
required
Id
string 
required
Labels
object 
required
Additional properties
string 
optional
ParentId
string 
required
RepoDigests
array[string]
required
RepoTags
array[string]
required
SharedSize
integer 
required
Size
integer 
required
VirtualSize
integer 
required
🔴500server error
Modified at 2022-09-10 17:56:06
Previous
Export several images
Next
Import images
Built with