---
title: "Get machine system stats"
method: GET
path: "/api/v1/machines/stats"
tags: ["Machines"]
---

# Get machine system stats

`GET /api/v1/machines/stats`

## Request

- Base URL: `http://:8080`
- URL: `http://:8080/api/v1/machines/stats`
- Auth: none declared

Get machine system stats.

Auth: Required (bearer token).
Scope: Organization-scoped in authenticated context.
Side effects: Read-only operation.

## Headers

- `Accept` string

## Response `200`

OK

- SystemStatsResponse: SystemStatsResponse schema
  - `data` object
    - `architecture` string
    - `cpu` object
      - `overall` number, double
      - `per_core` object[]
        - `core_id` integer
        - `usage` number, double
    - `cpu_cores` integer
    - `cpu_info` string
    - `disk` object
      - `allMounts` object[]
        - `avail` string
        - `capacity` string
        - `filesystem` string
        - `mountPoint` string
        - `size` string
        - `used` string
      - `available` number, double
      - `mountPoint` string
      - `percentage` number, double
      - `total` number, double
      - `used` number, double
    - `hostname` string
    - `kernel_version` string
    - `load` object
      - `fifteenMin` number, double
      - `fiveMin` number, double
      - `oneMin` number, double
      - `uptime` string
    - `memory` object
      - `percentage` number, double
      - `rawInfo` string
      - `total` number, double
      - `used` number, double
    - `network` object
      - `downloadSpeed` number, double
      - `interfaces` object[]
        - `bytesRecv` integer
        - `bytesSent` integer
        - `dropIn` integer
        - `dropOut` integer
        - `errorIn` integer
        - `errorOut` integer
        - `name` string
        - `packetsRecv` integer
        - `packetsSent` integer
      - `totalBytesRecv` integer
      - `totalBytesSent` integer
      - `totalPacketsRecv` integer
      - `totalPacketsSent` integer
      - `uploadSpeed` number, double
    - `os_type` string
    - `timestamp` string, date-time
  - `message` string
  - `status` string

## Other responses

- `400`: Bad Request _(validation or deserialization error)_
- `500`: Internal Server Error _(panics)_
- `default`

## Changes

- **2026-04-26** `09f18af670c4`: 3 info
  - api tag `Machines` added
  - api tag `api/v1/machines` removed
  - api tag `stats` removed
- **2026-04-18** `a16fedd4cd53`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nixopus/apis/nixopus-api/changes/api/v1/machines/stats/get.md)

---

[API](https://skmtc.dev/nixopus/apis/nixopus-api.md) - [All operations](https://skmtc.dev/nixopus/apis/nixopus-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nixopus/apis/nixopus-api/revisions/c5bacaea7239?raw)