List every app's usage metrics

GET/usage

Persistent usage metrics: durable, cumulative per-app counters (compute, memory, requests, storage) that survive a daemon restart, including retained records for deleted apps. Values are cumulative — diff two readings to get usage over a window. 501 with no app manager.

Responses

200 OKOK

UsageListResponse

snapshot_unix_nanointegerint64

usagearray | null

items

AppUsage

app_idstring

app_namestring

compute_vcpu_secondsnumberdouble

egress_bytesintegermin 0

finalized_atstring | nulldate-time

memory_mib_secondsnumberdouble

requestsintegermin 0

requests_by_codeobject

additional properties

integermin 0

storage_gib_secondsnumberdouble

updated_atstringdate-time

501 Not Implemented

ErrorResponse

codestring

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍GET/usage

cURL

curl '/usage'

JavaScript

const response = await fetch("/usage", {
  method: "GET",
});
const data = await response.json();

Python

import requests

response = requests.get(
    "/usage",
)
data = response.json()

Response

200 OK

{
  "snapshot_unix_nano": 0,
  "usage": [
    {
      "app_id": "string",
      "app_name": "string",
      "compute_vcpu_seconds": 0,
      "egress_bytes": 0,
      "finalized_at": "2026-01-02T15:04:05Z",
      "memory_mib_seconds": 0,
      "requests": 0,
      "requests_by_code": {},
      "storage_gib_seconds": 0,
      "updated_at": "2026-01-02T15:04:05Z"
    }
  ]
}