---
title: "List computers"
method: GET
path: "/api/v0/computers"
tags: ["Computers"]
---

# List computers

`GET /api/v0/computers`

Returns the computers owned by the authenticated client, ordered newest first. Provisioning steps are included only when `includeProvisioningSteps=true`.

## Query parameters

- `hostId` string, uuid
- `includeProvisioningSteps` 'true' | 'false' — Whether to include provisioning step details.
- `includeUnlisted` 'true' | 'false' — Whether to include Computers hidden from normal listings.

## Response `200`

Response for status 200

- ListComputers200ResponseBody
  - `computers` object[], required
    - `id` string, required
    - `hostId` string, uuid
    - `name` string, required
    - `isListed` boolean
    - `providerType` string, required — Compute provider backing this computer, e.g. 'byom' or 'e2b'.
    - `status` 'provisioning' | 'active' | 'error'
    - `createdAt` number, required
    - `provisioningSteps` object[]
      - `id` string, required
      - `name` string, required
      - `status` string, required
      - `error` string
      - `startedAt` number
      - `completedAt` number
      - `installSessionId` string
    - `relayClientUrl` string, uri
    - `relayAgentUrl` string, uri
    - `remoteUser` string
    - `clonedRepoDirectories` string[]
    - `ownerPrincipalKind` string
    - `ownerId` string
    - `computerSource` union
      - object
        - `kind` 'template', required
        - `templateId` string, required
      - object
        - `kind` 'execution-template', required
        - `templateId` string, required
      - object
        - `kind` 'computer', required
        - `computerId` string, required

## Other responses

- `400` — Response for status 400
- `401` — Response for status 401
- `500` — Response for status 500

## Changes

> 20 revisions in range; 13 could not be searched.

- **2026-08-05** `b702af89bbff` — 2 info
  - added the new optional `query` request parameter `includeUnlisted`
  - added the optional property `computers/items/isListed` to the response with the `200` status
- **2026-07-26** `749e76236673` — 2 info
  - removed the `byom` enum value from the `computers/items/providerType` response property for the response status `200`
  - removed the `e2b` enum value from the `computers/items/providerType` response property for the response status `200`

[Change history](https://skmtc.dev/factory/apis/factory-public-api/changes/api/v0/computers/get.md)

---

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