---
title: "Read CPU data"
method: GET
path: "/api/v1/metrics/cpu"
---

# Read CPU data

`GET /api/v1/metrics/cpu`

## Response `200`

OK

- CPUMetricResponse
  - `data` CPUData
    - `physical_core` integer
    - `logical_core` integer
    - `frequency` number
    - `temperature` number[], nullable
    - `free_percent` number
    - `usage_percent` number
  - `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

- **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` — 6 breaking, 2 info
  - the response property `data/temperature` became nullable for the status `200`
  - the response property `data/temperature` became nullable for the status `207`
  - the `data/temperature` response's property type/format changed from `number`/`` to `array`/`` for status `200`
  - the `data/temperature` response's property type/format changed from `number`/`` to `array`/`` for status `207`
  - …4 more
- **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/cpu/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)