---
title: "GET /system/df"
method: GET
path: "/system/df"
---

# GET /system/df

`GET /system/df`

Get data usage information

## Query parameters

- `type` union
  - 'container' | 'image' | 'volume'
  - string[]
- `verbose` boolean

## Response `200`

The request has succeeded.

- object
  - `ImagesDiskUsage` ImagesDiskUsage — represents system data usage for image resources.
    - `ActiveCount` integer — Count of active images.
    - `TotalCount` integer — Count of all images.
    - `Reclaimable` integer — Disk space that can be reclaimed by removing unused images.
    - `TotalSize` integer — Disk space in use by images.
    - `Items` unknown[] — List of image summaries.
      - unknown
  - `ContainersDiskUsage` ContainersDiskUsage — represents system data usage information for container resources.
    - `ActiveCount` integer — Count of active containers.
    - `TotalCount` integer — Count of all containers.
    - `Reclaimable` integer — Disk space that can be reclaimed by removing inactive containers.
    - `TotalSize` integer — Disk space in use by containers.
    - `Items` unknown[] — List of container summaries.
      - unknown
  - `VolumesDiskUsage` VolumesDiskUsage — represents system data usage for volume resources.
    - `ActiveCount` integer — Count of active volumes.
    - `TotalCount` integer — Count of all volumes.
    - `Reclaimable` integer — Disk space that can be reclaimed by removing inactive volumes.
    - `TotalSize` integer — Disk space in use by volumes.
    - `Items` unknown[] — List of volumes.
      - unknown
  - `BuildCacheDiskUsage` BuildCacheDiskUsage — represents system data usage for build cache resources.
    - `ActiveCount` integer — Count of active build cache records.
    - `TotalCount` integer — Count of all build cache records.
    - `Reclaimable` integer — Disk space that can be reclaimed by removing inactive build cache records.
    - `TotalSize` integer — Disk space in use by build cache records.
    - `Items` unknown[] — List of build cache records.
      - unknown

---

[API](https://skmtc.net/hexlet/apis/docker-engine-api.md) · [All operations](https://skmtc.net/hexlet/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hexlet/docker-engine-api/revisions/7dbd508c79cf/schema)