Docker Engine API
  1. Container
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
    • Delete builder cache
    • Create a new image from a container
    • Create an image
    • Export several images
    • List Images
    • Import images
    • Delete unused images
    • Search images
    • Remove an image
    • Export an image
    • Get the history of an image
    • Inspect an image
    • Push an image
    • Tag an image
  • Config
    • List configs
    • Create a config
    • Delete a config
    • Inspect a config
    • Update a Config
  • Container
    • Create a container
      POST
    • List containers
      GET
    • Delete stopped containers
      POST
    • Remove a container
      DELETE
    • Get an archive of a filesystem resource in a container
      GET
    • Get information about files in a container
      HEAD
    • Extract an archive of files or folders to a directory in a container
      PUT
    • Attach to a container
      POST
    • Attach to a container via a websocket
      GET
    • Get changes on a container’s filesystem
      GET
    • Export a container
      GET
    • Inspect a container
      GET
    • Kill a container
      POST
    • Get container logs
      GET
    • Pause a container
      POST
    • Rename a container
      POST
    • Resize a container TTY
      POST
    • Restart a container
      POST
    • Start a container
      POST
    • Get container stats based on resource usage
      GET
    • Stop a container
      POST
    • List processes running inside a container
      GET
    • Unpause a container
      POST
    • Update a container
      POST
    • Wait for a container
      POST
  • 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. Container

List containers

/v1.33
/v1.33
/v1.33
/v1.33
GET
/containers/json
Returns a list of containers. For details on the format, see the inspect endpoint.
Note that it uses a different, smaller representation of a container than inspecting a single container. For example,
the list of linked containers is not propagated .
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1.33/containers/json'
Response Response Example
200 - response
[
    {
        "Command": "echo 1",
        "Created": 1367854155,
        "HostConfig": {
            "NetworkMode": "default"
        },
        "Id": "8dfafdbc3a40",
        "Image": "ubuntu:latest",
        "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",
        "Labels": {
            "com.example.license": "GPL",
            "com.example.vendor": "Acme",
            "com.example.version": "1.0"
        },
        "Mounts": [
            {
                "Destination": "/data",
                "Driver": "local",
                "Mode": "ro,Z",
                "Name": "fac362...80535",
                "Propagation": "",
                "RW": false,
                "Source": "/data"
            }
        ],
        "Names": [
            "/boring_feynman"
        ],
        "NetworkSettings": {
            "Networks": {
                "bridge": {
                    "EndpointID": "2cdc4edb1ded3631c81f57966563e5c8525b81121bb3706a9a9a3ae102711f3f",
                    "Gateway": "172.17.0.1",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "IPAddress": "172.17.0.2",
                    "IPPrefixLen": 16,
                    "IPv6Gateway": "",
                    "MacAddress": "02:42:ac:11:00:02",
                    "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812"
                }
            }
        },
        "Ports": [
            {
                "PrivatePort": 2222,
                "PublicPort": 3333,
                "Type": "tcp"
            }
        ],
        "SizeRootFs": 0,
        "SizeRw": 12288,
        "State": "Exited",
        "Status": "Exit 0"
    },
    {
        "Command": "echo 222222",
        "Created": 1367854155,
        "HostConfig": {
            "NetworkMode": "default"
        },
        "Id": "9cd87474be90",
        "Image": "ubuntu:latest",
        "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",
        "Labels": {},
        "Mounts": [],
        "Names": [
            "/coolName"
        ],
        "NetworkSettings": {
            "Networks": {
                "bridge": {
                    "EndpointID": "88eaed7b37b38c2a3f0c4bc796494fdf51b270c2d22656412a2ca5d559a64d7a",
                    "Gateway": "172.17.0.1",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "IPAddress": "172.17.0.8",
                    "IPPrefixLen": 16,
                    "IPv6Gateway": "",
                    "MacAddress": "02:42:ac:11:00:08",
                    "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812"
                }
            }
        },
        "Ports": [],
        "SizeRootFs": 0,
        "SizeRw": 12288,
        "State": "Exited",
        "Status": "Exit 0"
    },
    {
        "Command": "echo 3333333333333333",
        "Created": 1367854154,
        "HostConfig": {
            "NetworkMode": "default"
        },
        "Id": "3176a2479c92",
        "Image": "ubuntu:latest",
        "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",
        "Labels": {},
        "Mounts": [],
        "Names": [
            "/sleepy_dog"
        ],
        "NetworkSettings": {
            "Networks": {
                "bridge": {
                    "EndpointID": "8b27c041c30326d59cd6e6f510d4f8d1d570a228466f956edf7815508f78e30d",
                    "Gateway": "172.17.0.1",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "IPAddress": "172.17.0.6",
                    "IPPrefixLen": 16,
                    "IPv6Gateway": "",
                    "MacAddress": "02:42:ac:11:00:06",
                    "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812"
                }
            }
        },
        "Ports": [],
        "SizeRootFs": 0,
        "SizeRw": 12288,
        "State": "Exited",
        "Status": "Exit 0"
    },
    {
        "Command": "echo 444444444444444444444444444444444",
        "Created": 1367854152,
        "HostConfig": {
            "NetworkMode": "default"
        },
        "Id": "4cb07b47f9fb",
        "Image": "ubuntu:latest",
        "ImageID": "d74508fb6632491cea586a1fd7d748dfc5274cd6fdfedee309ecdcbc2bf5cb82",
        "Labels": {},
        "Mounts": [],
        "Names": [
            "/running_cat"
        ],
        "NetworkSettings": {
            "Networks": {
                "bridge": {
                    "EndpointID": "d91c7b2f0644403d7ef3095985ea0e2370325cd2332ff3a3225c4247328e66e9",
                    "Gateway": "172.17.0.1",
                    "GlobalIPv6Address": "",
                    "GlobalIPv6PrefixLen": 0,
                    "IPAddress": "172.17.0.5",
                    "IPPrefixLen": 16,
                    "IPv6Gateway": "",
                    "MacAddress": "02:42:ac:11:00:05",
                    "NetworkID": "7ea29fc1412292a2d7bba362f9253545fecdfa8ce9a6e37dd10ba8bee7129812"
                }
            }
        },
        "Ports": [],
        "SizeRootFs": 0,
        "SizeRw": 12288,
        "State": "Exited",
        "Status": "Exit 0"
    }
]

Request

Query Params

Responses

🟢200no error
application/json
Body

🟠400bad parameter
🔴500server error
Modified at 2022-09-10 17:56:06
Previous
Create a container
Next
Delete stopped containers
Built with