---
title: "Read Visitors"
method: GET
path: "/api/demo/admin/visitors"
tags: ["demo-observability"]
---

# Read Visitors

`GET /api/demo/admin/visitors`

## Request

- Base URL: `https://api.quadrillion.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.quadrillion.io/api/demo/admin/visitors`
- Auth: none declared

## Query parameters

- `hours` integer

## Response `200`

Successful Response

- VisitorsSnapshot
  - `queriedAt` string, required
  - `windowStart` string, required
  - `stages` string[], required
  - `pool` StandbyPool, required: Warm placeholder workspaces waiting for a visitor. ``available`` is false on a cloud without the demo standby table, where the counts are meaningless rather than zero.
    - `available` boolean, required
    - `ready` integer, required
    - `warming` integer, required
    - `compute` ComputeTotals, required: What a set of ledger boxes cost at on-demand rates. ``unpriced_boxes`` counts boxes the rate card could not price, so a total that excludes them says so instead of reading as complete.
      - `boxes` integer, required
      - `openBoxes` integer, required
      - `onDemandUsd` string, required
      - `unpricedBoxes` integer, required
  - `visitors` VisitorSummary[], required
    - `userId` string, required
    - `email` string, required
    - `name` string, required
    - `standbyState` string, nullable, required
    - `joinedAt` string, required
    - `lastActiveAt` string, nullable, required
    - `workspaceIds` string[], required
    - `requests` integer, required
    - `modelCostUsd` string, required
    - `compute` ComputeTotals, required: What a set of ledger boxes cost at on-demand rates. ``unpriced_boxes`` counts boxes the rate card could not price, so a total that excludes them says so instead of reading as complete.
      - `boxes` integer, required
      - `openBoxes` integer, required
      - `onDemandUsd` string, required
      - `unpricedBoxes` integer, required
    - `furthestStage` string, nullable, required
    - `tasks` integer, required
    - `tasksFailed` integer, required
  - `warnings` string[], required

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-29** `24240445b715`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quadrillion/apis/quadrillion-cloud-api/changes/api/demo/admin/visitors/get.md)

---

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