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

# GET /v1/machine-infos

`GET /v1/machine-infos`

GetClusterMachineInfos returns paginated machines known by the receiver (leader/master node).

## Query parameters

- `page` integer
- `pageSize` integer
- `keywords` string
- `ip` string
- `hostname` string

## Response `200`

OK

- JadeTreeApiV1GetClusterMachineInfosReply
  - `machines` JadeTreeApiV1GetMachineInfoReply[] — machines returns paginated machines known by the receiver.
    - `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.
  - `total` string — total is the total number of matched machines.
  - `page` integer — page is the current page (1-based).
  - `pageSize` integer — pageSize is the requested page size.

---

[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)