---
title: "Read Docker container metrics"
method: GET
path: "/api/v1/metrics/docker"
---

# Read Docker container metrics

`GET /api/v1/metrics/docker`

## Response `200`

OK

- DockerMetricResponse
  - `data` ContainerData[]
    - `container_id` string
    - `container_name` string
    - `status` 'created' | 'running' | 'paused' | 'restarting' | 'removing' | 'exited' | 'dead'
    - `health` ContainerHealthStatus
      - `healthy` boolean
      - `source` 'container_health_check' | 'state_based_health_check'
      - `message` string
    - `running` boolean
    - `base_image` string
    - `exposed_ports` PortData[]
      - `port` string
      - `protocol` string
    - `started_at` integer — Unix timestamp
    - `finished_at` integer — Unix timestamp
    - `stats` ContainerStats
      - `cpu_percent` number
      - `memory_usage` integer
      - `memory_limit` integer
      - `memory_percent` number
      - `network_rx_bytes` integer
      - `network_tx_bytes` integer
      - `block_read_bytes` integer
      - `block_write_bytes` integer
      - `pids` integer
  - `capture` CaptureMetadata
    - `version` string
    - `mode` string
  - `errors` MetricErrorObject[], nullable
    - `metric` string[]
    - `err` string

## Other responses

- `207` — Multi-Status | Some of the data is not available
- `403` — Forbidden - Invalid authentication token

## Changes

- **2025-12-06** `577d4aa2949c` — 1 info
  - endpoint added
- **2024-12-16** `0e2250f78cf0` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bluewave-labs/apis/capture/changes/api/v1/metrics/docker/get.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/capture.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/capture/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/capture/revisions/76f1b333af18/schema)