---
title: "Get data usage information"
method: GET
path: "/system/df"
tags: ["System"]
---

# Get data usage information

`GET /system/df`

## Query parameters

- `type` string[]
- `verbose` boolean

## Response `200`

no error

- object
  - `ImageUsage` 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
  - `ContainerUsage` 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
  - `VolumeUsage` 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
  - `BuildCacheUsage` 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

## Other responses

- `500` — server error

---

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