---
title: "GET /v1/machine-info"
method: GET
path: "/v1/machine-info"
tags: ["MachineInfo"]
---

# GET /v1/machine-info

`GET /v1/machine-info`

## Response `200`

OK

- JadeTreeApiV1GetMachineInfoReply
  - `cpu` JadeTreeApiV1CPUInfo
    - `totalCores` integer
    - `totalHardwareThreads` integer
    - `processors` JadeTreeApiV1CPUProcessorItem[]
      - `id` integer
      - `vendor` string
      - `model` string
      - `totalCores` integer
      - `totalHardwareThreads` integer
      - `capabilities` string[]
      - `cores` JadeTreeApiV1CPUCoreItem[]
        - `id` integer
        - `hardwareThreads` integer
        - `logicalProcessors` integer[]
  - `memory` JadeTreeApiV1MemoryInfo
    - `totalPhysicalBytes` string
    - `totalUsableBytes` string
    - `supportedPageSizes` string[]
    - `usedBytes` string
    - `freeBytes` string
    - `sharedBytes` string
    - `buffCacheBytes` string
    - `availableBytes` string
    - `swapTotalBytes` string
    - `swapUsedBytes` string
    - `swapFreeBytes` string
  - `disks` JadeTreeApiV1DiskInfoItem[]
    - `name` string
    - `type` string
    - `sizeBytes` string
    - `vendor` string
    - `model` string
    - `serialNumber` string
    - `wwn` string
    - `mounts` JadeTreeApiV1DiskMountItem[]
      - `mountPoint` string
      - `fsType` string
      - `totalBytes` string
      - `usedBytes` string
      - `freeBytes` string
      - `freeRate` number, double
  - `network` JadeTreeApiV1NetworkInfo
    - `localIp` string
    - `outboundIp` string
    - `cidr` string
    - `dnsServers` string[]
    - `totalRxBytes` string
    - `totalTxBytes` string
    - `nics` string[]
  - `host` JadeTreeApiV1HostInfo
    - `hostName` string
    - `machineUuid` string — machineUuid is a best-effort host identifier (may collide across machines when cloned images share machine-id). Persisted rows use machineUuid + hostName + network.localIp as the composite unique key. On macOS it is sourced from `sysctl -n hw.uuid`. On Linux it is sourced from `/etc/machine-id` or `/var/lib/dbus/machine-id`.
  - `system` JadeTreeApiV1SystemInfo
    - `arch` string
    - `os` string
    - `version` string
    - `kernel` string
  - `uid` string — uid is the persisted machine row ID.
  - `agent` JadeTreeApiV1AgentInfo
    - `endpoint` string — endpoint is the backward-compatible merged endpoint string.
    - `version` string — version is the collector self-reported version.
    - `httpEndpoint` string — httpEndpoint is the collector self-reported HTTP endpoint.
    - `grpcEndpoint` string — grpcEndpoint is the collector self-reported gRPC endpoint.

---

[API](https://skmtc.net/aide-family/apis/untitled-api-4.md) · [All operations](https://skmtc.net/aide-family/apis/untitled-api-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aide-family/untitled-api-4/revisions/7c1198712e80/schema)