# List or read pools

URL: https://heaven.dev/docs/reference/pools/view
Updated: 2026-11-21

List accessible pools or read one pool's capacity and settings. Use `parts` to include only selected sections such as usage or snapshots.

`GET /v1/pool/`

## Parameters

- `pool` (string): Pool name or ID. Omit to list accessible pools.
- `parts` (string[]): Section to include. Choose from usage, snapshots, plans and capacity. Use none for no additional sections. The default is all sections. MCP defaults to none.
- `organization` (string): Organization name or ID. A credential, named resource or sole membership can select the organization for you.

## Returns

- `data` (object, always present): Accessible pools and requested details.
  - `capacity` (object): Capacity purchases and allocations for this account. May be omitted.
    - `had_computer` (boolean, always present): Whether this account has ever created a Computer, including a deleted one.
    - `purchases` (object[] | null, always present): Purchases held by the account, including payment-pending or lapsed purchases.
      - `items` (object): A capacity purchase and its payment status.
        - `checkout_url` (string): Payment page for a pending purchase. May be omitted.
        - `created_at` (string (date-time), always present): When the purchase was created.
        - `id` (string, always present): Purchase ID used for changes or release.
        - `kind` (string, always present): Billing model.
        - `memory_bytes` (integer, always present): RAM included by this purchase, in bytes.
        - `next_terms` (object): Scheduled replacement terms. May be omitted.
          - `amount_micros` (integer, always present): Price per billing period before discounts or a trial, in millionths of the currency.
          - `currency` (string, always present): Currency of the price.
          - `egress_gb` (integer, always present): Included monthly internet egress in decimal gigabytes.
          - `model` (string, always present): Hourly or monthly billing. Values: `"hourly"`, `"monthly"`.
          - `plan` (integer, always present): Plan number.
          - `rate_card` (object, always present): Rates for usage beyond included allowances.
            - `egress_micros_per_gb` (integer, always present): Internet egress overage price per decimal gigabyte, in millionths of a dollar.
            - `hourly_minimum_minutes` (integer, always present): Minimum billed duration of an hourly purchase, in minutes.
          - `storage_gb` (integer, always present): Included storage in decimal gigabytes.
          - `units` (integer, always present): Number of capacity units purchased.
        - `next_terms_at` (string (date-time)): When replacement terms take effect. Monthly changes apply at renewal. May be omitted.
        - `pays_micros` (integer): Current price per hour or month according to `kind`, in millionths of a dollar. May be omitted.
        - `plan` (integer, always present): Purchased plan number.
        - `pools` (string[] | null, always present): Pools that use capacity in this purchase's placement.
        - `region` (string): Purchase's region. May be omitted.
        - `state` (string, always present): `active` capacity is available. `pending` awaits its first monthly payment. `out_of_funds`, `capped` (stopped at the spending cap) and `unpaid` purchases have lapsed and contribute no capacity.
        - `storage_bytes` (integer, always present): Storage included by this purchase, in bytes.
        - `terms` (object): Price and allowances agreed to for this purchase. May be omitted.
          - `amount_micros` (integer, always present): Price per billing period before discounts or a trial, in millionths of the currency.
          - `currency` (string, always present): Currency of the price.
          - `egress_gb` (integer, always present): Included monthly internet egress in decimal gigabytes.
          - `model` (string, always present): Hourly or monthly billing. Values: `"hourly"`, `"monthly"`.
          - `plan` (integer, always present): Plan number.
          - `rate_card` (object, always present): Rates for usage beyond included allowances.
            - `egress_micros_per_gb` (integer, always present): Internet egress overage price per decimal gigabyte, in millionths of a dollar.
            - `hourly_minimum_minutes` (integer, always present): Minimum billed duration of an hourly purchase, in minutes.
          - `storage_gb` (integer, always present): Included storage in decimal gigabytes.
          - `units` (integer, always present): Number of capacity units purchased.
        - `vcpus` (integer, always present): vCPUs included by this purchase.
    - `servers` (object[] | null, always present): Capacity totals grouped by where the account's pools can use them.
      - `items` (object): Purchased and allocated capacity for pools in one placement.
        - `memory_allocated_bytes` (integer, always present): Purchased RAM allocated to pools here, in bytes.
        - `memory_bought_bytes` (integer, always present): RAM purchased here, in bytes.
        - `pools` (string[] | null, always present): Pools using this placement's capacity.
        - `region` (string): Region containing these pools. May be omitted.
        - `storage_allocated_bytes` (integer, always present): Purchased storage allocated to pools here, in bytes.
        - `storage_bought_bytes` (integer, always present): Storage purchased here, in bytes.
        - `vcpus_allocated` (integer, always present): Purchased vCPUs allocated to pools here.
        - `vcpus_bought` (integer, always present): vCPUs purchased here.
    - `storage` (object[] | null, always present): Storage included and used in each placement group.
      - `items` (object): The account's storage in one placement, including stopped pools.
        - `included_bytes` (integer, always present): Storage included by the account's purchases here, in bytes.
        - `region` (string): Region of this storage. May be omitted.
        - `used_bytes` (integer, always present): Files and snapshots stored here as last measured, in bytes.
  - `plans` (object): Plans available for this account. May be omitted.
    - `egress_micros_per_gb` (integer, always present): Internet egress overage price per decimal gigabyte, in millionths of a dollar.
    - `plans` (object[] | null, always present): Available plan definitions, including approval and current capacity availability.
      - `items` (object): A plan's capacity, prices and availability. Prices are millionths of a US dollar.
        - `approval` (boolean): Whether buying this plan requires approval. May be omitted.
        - `approved` (boolean): Whether this account has that approval. May be omitted.
        - `egress_bytes` (integer, always present): Monthly internet egress added to the account's allowance, in bytes.
        - `hourly_micros` (integer, always present): Hourly price for this account.
        - `hourly_passes_monthly_hours` (integer, always present): Hours held in a month beyond which hourly billing costs more than monthly.
        - `memory_bytes` (integer, always present): Plan's RAM allocation, in bytes.
        - `monthly_micros` (integer, always present): Monthly price for this account.
        - `no_room` (boolean): Whether all placements lack room for a new purchase. An existing purchase may still have room to grow. May be omitted.
        - `plan` (integer, always present): Plan number accepted by purchase commands.
        - `public_ports` (integer, always present): Public port allowance for an account holding only this plan in a placement.
        - `storage_bytes` (integer, always present): Plan's included storage, in bytes.
        - `units` (integer, always present): Number of capacity units in this plan.
        - `vcpus` (integer, always present): Plan's vCPU allocation.
  - `pool` (object): Additional detail when one pool was selected. May be omitted.
    - `default_disk_bytes` (integer): Default disk size for new Computers, in bytes. May be omitted.
    - `default_domain` (string): Default domain used to name new Computers. May be omitted.
    - `default_vcpus` (integer): Default per-Computer CPU setting for new Computers. May be omitted.
    - `operations` (object[] | null, always present): Recent pool operations you started.
      - `items` (object): A recent pool operation in brief.
        - `created_at` (string (date-time), always present): When the operation was accepted.
        - `id` (string, always present): Operation ID to read for full progress.
        - `kind` (string, always present): Pool change being tracked.
    - `setup_script` (string): Script for new Computers, visible to people allowed to create them. May be omitted.
    - `shares` (object[]): Pool's shares, visible to its account's managers. May be omitted.
      - `items` (object): A pool share and the Computers its holders created through it.
        - `commands` (string[]): Additional commands granted through the share. May be omitted.
        - `computers` (integer, always present): Computers in the pool created by this share's holders.
        - `email` (string): Recipient's email, including an address whose invitation has not yet been claimed. May be omitted.
        - `organization` (string): Recipient organization, when shared with an organization. May be omitted.
        - `pool` (string, always present): Pool name.
        - `role` (string, always present): Role granted through this share.
        - `team` (string): Recipient team, when shared with a team. May be omitted.
        - `user_id` (string): Individual recipient's user ID. May be omitted.
  - `pools` (object[] | null, always present): Selected pools and their reported state.
    - `items` (object): A pool's allocation, settings and reported state.
      - `account_id` (string, always present): Account that owns the pool.
      - `allowance` (object, always present): Resource allocation.
        - `disk_allowance_bytes` (integer, always present): Pool's included storage for files and snapshots, in bytes.
        - `memory_bytes` (integer, always present): Pool's guaranteed RAM allocation, in bytes.
        - `vcpus` (integer, always present): Pool's vCPU allocation.
      - `billing` (object): Pool's payment state and any pending checkout. May be omitted.
        - `checkout_url` (string): Checkout page while a monthly purchase waits for payment. May be omitted.
        - `delete_at` (string (date-time)): Scheduled deletion time, when one is set. May be omitted.
        - `deleting` (boolean): Whether deletion is in progress. May be omitted.
        - `out_of_funds_at` (string (date-time)): When the pool's hourly capacity ran out of wallet funds. May be omitted.
        - `paid_through` (string (date-time)): End of the paid subscription period. May be omitted.
        - `provided` (boolean): True when Heaven provides this capacity without charging the account. May be omitted.
        - `subscription_status` (string): Payment provider's subscription state. May be omitted.
        - `unpaid_since` (string (date-time)): When the account's monthly renewal first went unpaid. May be omitted.
      - `change` (object): A capacity change still being applied and any action needed. May be omitted.
        - `message` (string, always present): What is delaying the change and what you can do.
        - `since` (string (date-time), always present): When this pending change began.
      - `computers` (object, always present): How many of the pool's Computers you can see, by state. The Computer list with this pool in `pool` lists them.
        - `states` (map<string, integer> | null, always present): How many are in each state; a state none is in is left out.
        - `total` (integer, always present): Computers you can see in the pool.
        - `waiting_for_memory` (integer, always present): Starting or restarting Computers that wait for memory to start.
      - `cpu_cores` (number): Current measured vCPUs in use by the pool's Computers. May be omitted.
      - `disk` (object | null, always present): Latest storage measurements.
        - `alternative-1` (object): A pool's reported storage usage.
          - `allowance_bytes` (integer, always present): Included storage, in bytes.
          - `files_bytes` (integer, always present): Storage attributed to Computer files beyond their base images, in bytes.
          - `snapshot_bytes` (integer): Storage attributed to snapshots, in bytes. May be omitted.
          - `unknown` (integer): Number of Computers whose disk usage could not be measured. May be omitted.
          - `used_bytes` (integer, always present): Files and snapshots counted against the pool's storage, in bytes.
      - `id` (string, always present): Pool's stable ID.
      - `lifecycle` (string, always present): Pool's lifecycle state.
      - `moves` (boolean, always present): Whether Computers can currently move between pools in this placement.
      - `name` (string, always present): Pool name.
      - `observed_at` (string (date-time) | null, always present): When the pool was measured, or null before a measurement.
      - `organization` (string): Owning organization's name, when applicable. May be omitted.
      - `owner_email` (string): Personal account owner's email for a pool shared with you. May be omitted.
      - `power` (string, always present): Pool's saved power setting.
      - `public_ports` (object): Published-port usage and availability in the pool's applicable allowance. May be omitted.
        - `limit` (integer, always present): Ports permitted within this allowance.
        - `offered` (boolean, always present): Whether an address is available for publishing ports. Required even with unused allowance.
        - `used` (integer, always present): Ports currently used within this allowance.
      - `received_at` (string (date-time) | null, always present): When Heaven received the observation, or null before one arrives.
      - `received_bytes` (string | null, always present): Recorded inbound bytes as a decimal string, or null without a measurement.
      - `region` (string): Pool's region. May be omitted.
      - `sent_bytes` (string | null, always present): Recorded outbound bytes as a decimal string, or null without a measurement.
      - `server_key` (string, always present): Opaque placement key. Matching keys permit moves between the pools.
      - `shared_to` (string[]): Your organizations receiving this pool share. May be omitted.
      - `shared_with` (integer, always present): Number of people, organizations and teams sharing this pool.
      - `shared_with_you` (boolean): Whether you access this pool through a share. May be omitted.
      - `stale` (boolean, always present): Whether the observation is outdated.
      - `static_address` (string): Static IPv4 address attached to this pool. May be omitted.
      - `stop_last` (boolean, always present): Whether this pool is marked to stop last when available capacity falls.
      - `storage` (string): Text summary of file and snapshot use against included storage. May be omitted.
  - `snapshots` (object): Pool snapshots available in the selected scope. May be omitted.
    - `pool_snapshots` (object[] | null, always present): Selected pool snapshots.
      - `items` (object): Disk snapshots captured from a pool. Sharing grants only disk-copy access.
        - `computers` (integer, always present): Number of Computers represented by its parts.
        - `created_at` (string (date-time), always present): When the grouped snapshot was created.
        - `created_by` (object, always present): Who requested the snapshot.
          - `email` (string | null, always present): Their email address, or null when none is available.
          - `user_id` (string, always present): Person's user ID.
        - `expires_at` (string (date-time) | null, always present): When it expires, or null if it has no expiry.
        - `id` (string, always present): Pool snapshot's ID.
        - `name` (string, always present): Its name within the pool.
        - `note` (string, always present): Saved note about the snapshot.
        - `parts` (object[]): Individual saved disks, included when reading one snapshot. May be omitted.
          - `items` (object): A Computer's disk snapshot within a pool snapshot. Copying a part requires both Computer and snapshot identities.
            - `computer` (object, always present): Source Computer.
            - `snapshot` (object, always present): Its saved disk snapshot.
        - `pool` (object, always present): Source pool and its account.
          - `id` (string, always present): Source pool's ID.
          - `name` (string, always present): Source pool's name.
          - `owner` (object, always present): Account that owns the source pool.
            - `account_id` (string, always present): Account ID.
            - `email` (string): Personal account owner's email. May be omitted.
            - `kind` (string, always present): Whether the owner is an organization or a personal account.
            - `name` (string): Organization name. May be omitted.
        - `region` (string): Region containing the source pool. May be omitted.
        - `shared` (boolean, always present): True when another account shared this snapshot with you.
        - `shared_with` (object[]): People this snapshot is shared with, visible to its account's members. May be omitted.
          - `items` (object): The person associated with a snapshot action or share.
            - `email` (string | null, always present): Their email address, or null when none is available.
            - `user_id` (string, always present): Person's user ID.
        - `state` (string, always present): Grouped snapshot's recorded state.
  - `unavailable` (string[]): Requested parts that could not be read this time. May be omitted.
  - `usage` (object): Usage history for the selected pools, when requested. May be omitted.
    - `pools` (object[] | null, always present): Each pool's usage history.
      - `items` (object): A pool's usage history and allocation.
        - `busiest` (object[] | null, always present): Up to five Computers ordered by highest average CPU use.
          - `items` (object): One Computer's average CPU use and peak memory use in a pool's busiest list.
            - `computer_id` (string, always present): Computer ID.
            - `cpu_vcpus_avg` (number | null, always present): Average vCPUs in use over the range.
            - `memory_bytes_peak` (number | null, always present): Peak measured memory use in bytes.
            - `name` (string): Its name when available. May be omitted.
        - `computers` (object[]): Computers ordered by egress, with peak memory use. May be omitted.
          - `items` (object): One Computer's outbound traffic and peak memory use over the selected range.
            - `computer_id` (string, always present): Computer ID.
            - `egress_bytes` (integer, always present): Bytes sent directly to the internet.
            - `front_door_bytes` (integer, always present): Bytes sent through Heaven's front doors to visitors.
            - `memory_bytes_peak` (number | null, always present): Peak measured memory use in bytes, or null if unmeasured.
            - `name` (string): Computer's name when available. May be omitted.
        - `id` (string, always present): Pool ID.
        - `memory_bytes` (integer, always present): Pool's RAM allocation in bytes.
        - `organization` (string): Owning organization's name, when applicable. May be omitted.
        - `pool` (string, always present): Pool name.
        - `series` (object[], always present): Time-ordered intervals using the summary's measure names and units. Unmeasured values are omitted.
          - `items` (object): Measurements for one interval. Unmeasured values are omitted.
        - `storage_allowance_bytes` (integer, always present): Pool's included storage in bytes.
        - `summary` (object, always present): Usage over the selected range.
          - `cpu_vcpus_avg` (number | null, always present): Average vCPUs used by the pool's Computers over measured minutes.
          - `cpu_vcpus_peak` (number | null, always present): Average vCPUs used during the busiest measured minute.
          - `cpu_vcpus_peak_at` (string (date-time)): Busiest CPU minute, included in the summary. May be omitted.
          - `disk_used_bytes_peak` (integer | null, always present): Highest combined file use measured during the interval, in bytes, excluding snapshots.
          - `egress_bytes` (integer): Bytes sent directly to the internet. May be omitted.
          - `front_door_bytes` (integer): Bytes sent to visitors through Heaven's front doors. May be omitted.
          - `io_read_bytes` (integer | null, always present): Bytes read from the Computers' disks.
          - `io_write_bytes` (integer | null, always present): Bytes written to the Computers' disks.
          - `memory_bytes_avg` (number | null, always present): Average combined memory use in bytes over measured minutes.
          - `memory_bytes_peak` (number | null, always present): Peak combined memory use during a measured minute, in bytes.
          - `memory_bytes_peak_at` (string (date-time)): Busiest memory minute, included in the summary. May be omitted.
          - `net_rx_bytes` (integer | null, always present): Bytes received by the pool's Computers.
          - `net_tx_bytes` (integer | null, always present): Bytes sent by the pool's Computers.
          - `start` (string (date-time), always present): Interval's start.
          - `storage_bytes` (integer | null, always present): Latest file use on running Computers, in bytes, excluding stale readings and snapshots.
        - `vcpus` (integer, always present): Pool's vCPU allocation.
    - `range` (string, always present): Selected history range.
    - `resolution_seconds` (integer, always present): Duration of each interval in seconds.
    - `totals` (object, always present): Usage summed across the listed pools at matching times.
      - `cpu` (object, always present): Combined CPU use, in vCPUs.
        - `avg` (number | null, always present): Average over measured points.
        - `now` (number): Latest measured value. May be omitted.
        - `peak` (number | null, always present): Highest combined point.
        - `peak_at` (string (date-time) | null, always present): When that peak occurred.
        - `pools_at_peak` (object[] | null, always present): Pool contributions at the combined peak.
          - `items` (object): A pool's contribution to a combined usage peak.
            - `id` (string, always present): Pool ID.
            - `pool` (string, always present): Pool name.
            - `value` (number, always present): Its contribution, in the enclosing measure's units.
        - `total` (number): Sum over the range, used for egress. May be omitted.
      - `egress` (object, always present): Combined direct internet and front-door egress, in bytes.
        - `avg` (number | null, always present): Average over measured points.
        - `now` (number): Latest measured value. May be omitted.
        - `peak` (number | null, always present): Highest combined point.
        - `peak_at` (string (date-time) | null, always present): When that peak occurred.
        - `pools_at_peak` (object[] | null, always present): Pool contributions at the combined peak.
          - `items` (object): A pool's contribution to a combined usage peak.
            - `id` (string, always present): Pool ID.
            - `pool` (string, always present): Pool name.
            - `value` (number, always present): Its contribution, in the enclosing measure's units.
        - `total` (number): Sum over the range, used for egress. May be omitted.
      - `memory` (object, always present): Combined measured memory use, in bytes.
        - `avg` (number | null, always present): Average over measured points.
        - `now` (number): Latest measured value. May be omitted.
        - `peak` (number | null, always present): Highest combined point.
        - `peak_at` (string (date-time) | null, always present): When that peak occurred.
        - `pools_at_peak` (object[] | null, always present): Pool contributions at the combined peak.
          - `items` (object): A pool's contribution to a combined usage peak.
            - `id` (string, always present): Pool ID.
            - `pool` (string, always present): Pool name.
            - `value` (number, always present): Its contribution, in the enclosing measure's units.
        - `total` (number): Sum over the range, used for egress. May be omitted.
      - `memory_bytes` (integer, always present): Their total RAM allocation in bytes.
      - `storage` (object, always present): Combined measured file use on running Computers, in bytes, excluding snapshots.
        - `avg` (number | null, always present): Average over measured points.
        - `now` (number): Latest measured value. May be omitted.
        - `peak` (number | null, always present): Highest combined point.
        - `peak_at` (string (date-time) | null, always present): When that peak occurred.
        - `pools_at_peak` (object[] | null, always present): Pool contributions at the combined peak.
          - `items` (object): A pool's contribution to a combined usage peak.
            - `id` (string, always present): Pool ID.
            - `pool` (string, always present): Pool name.
            - `value` (number, always present): Its contribution, in the enclosing measure's units.
        - `total` (number): Sum over the range, used for egress. May be omitted.
      - `storage_allowance_bytes` (integer, always present): Their total included storage in bytes.
      - `vcpus` (integer, always present): Listed pools' total vCPU allocation.
  - `withheld` (string[]): Requested parts your credential or role cannot read. May be omitted.

## Errors

Each code is explained in full at https://heaven.dev/docs/reference/errors.

| Code | Status | What happened |
|---|---:|---|
| `invalid` | 400 | An input is missing or invalid. |
| `unauthenticated` | 401 | The credential is missing, invalid, expired or revoked. |
| `denied` | 403 | The caller lacks permission for this action. |
| `not_found` | 404 | The resource is absent or inaccessible to this caller. |
| `conflict` | 409 | The request conflicts with the current resource state or an earlier request. |
| `over_capacity` | 409 | The request exceeds a resource or credential allowance. |
| `access_list_full` | 409 | The change would exceed the access-list allowance. |
| `rate_limited` | 429 | The caller's request rate exceeds its limit. |
| `busy` | 429 | Too much work is in progress to accept this request. |
| `unknown` | 503 | The outcome is unconfirmed; a change may have happened. |
| `unavailable` | 503 | The service or requested feature is unavailable. |

## Notes

- API key permission: `pool view`.

## Examples

```sh tab="heaven CLI"
heaven pool view [POOL]
  [--part PART ...]
  [--organization ORGANIZATION]
```

```sh tab="SSH"
ssh cli@heaven.dev pool view [POOL]
  [--part PART ...]
  [--organization ORGANIZATION]
```

```sh tab="cURL"
curl "https://heaven.dev/v1/pool/?pool=web" \
  -H "Authorization: Bearer $HEAVEN_API_KEY"
```

```json tab="MCP"
{ "tool": "pool_view",
  "arguments": { "pool": "web" } }
```

Response:

```json title="Response excerpt"
{
  "version": 1,
  "data": {
    "capacity": {
      "had_computer": true,
      "purchases": [
        {
          "created_at": "2026-11-16T12:00:00Z",
          "id": "cap-5020df95ff69b435",
          "kind": "hourly",
          "memory_bytes": 8589934592,
          "pays_micros": 41096,
          "plan": 1,
          "pools": [
            "web"
          ],
          "state": "active",
          "storage_bytes": 100000000000,
          "terms": {
            "amount_micros": 41096,
            "currency": "usd",
            "egress_gb": 500,
            "model": "hourly",
            "plan": 1,
            "rate_card": {
              "egress_micros_per_gb": 50000,
              "hourly_minimum_minutes": 60
            },
            "storage_gb": 100,
            "units": 1
          },
          "vcpus": 2
        }
      ],
      "servers": [
        {
          "memory_allocated_bytes": 8589934592,
          "memory_bought_bytes": 8589934592,
          "pools": [
            "web"
          ],
          "storage_allocated_bytes": 100000000000,
          "storage_bought_bytes": 100000000000,
          "vcpus_allocated": 2,
          "vcpus_bought": 2
        }
      ],
      "storage": [
        {
          "included_bytes": 100000000000,
          "used_bytes": 0
        }
      ]
    },
    "plans": {
      "egress_micros_per_gb": 50000,
      "plans": [
        {
          "egress_bytes": 500000000000,
          "hourly_micros": 41096,
          "hourly_passes_monthly_hours": 487,
          "memory_bytes": 8589934592,
          "monthly_micros": 20000000,
          "plan": 1,
          "public_ports": 5,
          "storage_bytes": 100000000000,
          "units": 1,
          "vcpus": 2
        },
        {
          "egress_bytes": 1000000000000,
          "hourly_micros": 82192,
          "hourly_passes_monthly_hours": 487,
          "memory_bytes": 17179869184,
          "monthly_micros": 40000000,
          "plan": 2,
          "public_ports": 6,
          "storage_bytes": 250000000000,
          "units": 2,
          "vcpus": 4
        },
        {
          "egress_bytes": 2000000000000,
          "hourly_micros": 164384,
          "hourly_passes_monthly_hours": 487,
          "memory_bytes": 34359738368,
          "monthly_micros": 80000000,
          "no_room": true,
          "plan": 3,
          "public_ports": 8,
          "storage_bytes": 500000000000,
          "units": 4,
          "vcpus": 8
        }
      ]
    },
    "pool": {
      "operations": [],
      "shares": []
    },
    "pools": [
      {
        "account_id": "ac64dff4-edfb-4b88-a0aa-c8b39d19dc92",
        "allowance": {
          "disk_allowance_bytes": 100000000000,
          "memory_bytes": 8589934592,
          "vcpus": 2
        },
        "billing": {},
        "computers": {
          "states": {
            "running": 2
          },
          "total": 2,
          "waiting_for_memory": 0
        },
        "disk": null,
        "id": "pool-67fdddaeccadede9",
        "lifecycle": "active",
        "moves": true,
        "name": "web",
        "observed_at": null,
        "organization": "acme",
        "power": "running",
        "public_ports": {
          "limit": 5,
          "offered": true,
          "used": 0
        },
        "received_at": "2026-11-16T12:00:00Z",
        "received_bytes": null,
        "sent_bytes": null,
        "server_key": "a43ab10900e55826",
        "shared_with": 0,
        "stale": true,
        "stop_last": false
      }
    ],
    "snapshots": {
      "pool_snapshots": []
    },
    "usage": {
      "pools": [
        {
          "busiest": [],
          "id": "pool-67fdddaeccadede9",
          "memory_bytes": 8589934592,
          "organization": "acme",
          "pool": "web",
          "series": [
            {},
            {},
            {}
          ],
          "storage_allowance_bytes": 100000000000,
          "summary": {
            "cpu_vcpus_avg": null,
            "cpu_vcpus_peak": null,
            "disk_used_bytes_peak": null,
            "io_read_bytes": null,
            "io_write_bytes": null,
            "memory_bytes_avg": null,
            "memory_bytes_peak": null,
            "net_rx_bytes": null,
            "net_tx_bytes": null,
            "start": "2026-11-16T11:00:00Z",
            "storage_bytes": null
          },
          "vcpus": 2
        }
      ],
      "range": "24h",
      "resolution_seconds": 300,
      "totals": {
        "cpu": {
          "avg": null,
          "peak": null,
          "peak_at": null,
          "pools_at_peak": []
        },
        "egress": {
          "avg": null,
          "peak": null,
          "peak_at": null,
          "pools_at_peak": []
        },
        "memory": {
          "avg": null,
          "peak": null,
          "peak_at": null,
          "pools_at_peak": []
        },
        "memory_bytes": 8589934592,
        "storage": {
          "avg": null,
          "peak": null,
          "peak_at": null,
          "pools_at_peak": []
        },
        "storage_allowance_bytes": 100000000000,
        "vcpus": 2
      }
    }
  }
}
```
