Docker Engine API
docker · Developer Tools
The Engine API is an HTTP API served by Docker Engine. It is the API the Docker client uses to communicate with the Engine, so everything the Docker client can do can be done with the API. Most of the client's commands map directly to API endpoints (e.g. `docker ps` is `GET /containers/json`). The notable exception is running containers, which consists of several API calls. # Errors The API uses standard HTTP status codes to indicate the success or failure of the API call. The body of the res
Authentication
Sample Requests
List configs
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs?filters=example"
import requests
params = {
"filters": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs');
url.searchParams.set('filters', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs")
q := baseURL.Query()
q.Set("filters", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs")
uri.query = URI.encode_www_form({
"filters" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/docker.com/engine/1.33/configs?" . http_build_query([
"filters" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Stream real-time events from the server. Various objects within Docker report events when something happens to them. Containers report these events: `attach`, `commit`, `copy`, `create`, `destroy`, `detach`, `die`, `exec_create`, `exec_detach`, `exec_start`, `export`, `health_status`, `kill`, `oom
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/docker.com/engine/1.33/events?since=example&until=example&filters=example"
import requests
params = {
"since": "example",
"until": "example",
"filters": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/docker.com/engine/1.33/events",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/docker.com/engine/1.33/events');
url.searchParams.set('since', 'example');
url.searchParams.set('until', 'example');
url.searchParams.set('filters', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/docker.com/engine/1.33/events")
q := baseURL.Query()
q.Set("since", "example")
q.Set("until", "example")
q.Set("filters", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/docker.com/engine/1.33/events")
uri.query = URI.encode_www_form({
"since" => "example",
"until" => "example",
"filters" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/docker.com/engine/1.33/events?" . http_build_query([
"since" => "example",
"until" => "example",
"filters" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Returns a list of networks. For details on the format, see [the network inspect endpoint](#operation/NetworkInspect). Note that it uses a different, smaller representation of a network than inspecting a single network. For example, the list of containers attached to the network is not propagated in
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks?filters=example"
import requests
params = {
"filters": "example"
}
response = requests.get(
"https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks');
url.searchParams.set('filters', 'example');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks")
q := baseURL.Query()
q.Set("filters", "example")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks")
uri.query = URI.encode_www_form({
"filters" => "example"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/docker.com/engine/1.33/networks?" . http_build_query([
"filters" => "example"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Docker Engine API?
Docker Engine API is a Developer Tools API. Developers commonly use developer tools APIs for:
- automating code review and quality checks
- integrating CI/CD pipelines and build systems
- managing feature flags and A/B tests
- monitoring errors and application performance
- generating and validating test data
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Docker Engine API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide · Learn about API keys · What is REST?