---
title: "Read Disk data"
method: GET
path: "/api/v1/metrics/disk"
---

# Read Disk data

`GET /api/v1/metrics/disk`

## Response `200`

OK

- DiskMetricResponse
  - `data` DiskData[]
    - `device` string
    - `mountpoint` string
    - `total_bytes` integer, nullable
    - `free_bytes` integer, nullable
    - `used_bytes` integer, nullable
    - `usage_percent` number, nullable
    - `total_inodes` integer, nullable
    - `free_inodes` integer, nullable
    - `used_inodes` integer, nullable
    - `inodes_usage_percent` number, nullable
    - `read_bytes` integer, nullable
    - `write_bytes` integer, nullable
    - `read_time` integer, nullable
    - `write_time` integer, nullable
  - `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

## Changes

- **2026-07-17** `76f1b333af18` — 2 info
  - added the optional property `data/items/mountpoint` to the response with the `200` status
  - added the optional property `data/items/mountpoint` to the response with the `207` status
- **2025-12-06** `577d4aa2949c` — 2 warning, 2 info
  - removed the optional property `errors/items/error` from the response with the `200` status
  - removed the optional property `errors/items/error` from the response with the `207` status
  - added the optional property `errors/items/err` to the response with the `200` status
  - added the optional property `errors/items/err` to the response with the `207` status
- **2025-07-17** `a5791047c7e4` — 2 breaking, 2 info
  - the `errors/items/metric` response's property type/format changed from `string`/`` to `array`/`` for status `200`
  - the `errors/items/metric` response's property type/format changed from `string`/`` to `array`/`` for status `207`
  - the endpoint scheme security `type AND scheme AND bearerFormat` was added to the API
  - the endpoint scheme security `bearerAuth` was removed from the API
- **2025-06-04** `69b4529f7c41` — 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/disk/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)