---
title: "List Machines"
method: GET
path: "/api/v1/machines"
tags: ["machines"]
---

# List Machines

`GET /api/v1/machines`

List all machines registered by the authenticated user, ordered by most recently updated.

## Response `200`

Successful Response

- MachineListResponse — Response containing all machines for the authenticated user.
  - `machines` MachineDescriptor[], required — List of machines ordered by most recently updated
    - `id` string, required — Unique machine identifier
    - `name` string, required — Friendly name unique per user
    - `hostname` string, nullable — OS hostname of the machine
    - `platform` string, nullable — Operating system platform (e.g. linux, darwin)
    - `architecture` string, nullable — CPU architecture (e.g. x86_64, arm64)
    - `daemon_version` string, nullable — Semantic version of the running daemon
    - `status` string, required — Current machine status (online, offline, etc.)
    - `last_seen_at` string, date-time, nullable — Timestamp of the last heartbeat from this machine
    - `created_at` string, date-time, required — Timestamp when the machine was first registered
    - `updated_at` string, date-time, required — Timestamp of the most recent update
    - `metadata` object, nullable — Arbitrary key-value metadata about the machine

---

[API](https://skmtc.dev/omnara/apis/omnara-api.md) · [All operations](https://skmtc.dev/omnara/apis/omnara-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnara/omnara-api/revisions/624048e40cad/schema)