---
title: "GET /v1/billing/usage/sandbox — per-sandbox/per-day usage for the key's org."
method: GET
path: "/v1/billing/usage/sandbox"
tags: ["billing"]
---

# GET /v1/billing/usage/sandbox — per-sandbox/per-day usage for the key's org.

`GET /v1/billing/usage/sandbox`

Return billable usage grouped by sandbox for a selected UTC time range.

## Response `200`

Per-sandbox / per-day usage

- UsageBreakdown — Compute-on-read usage breakdown for an org over a window: per-(sandbox, day) quantity rows plus a directory of the sandboxes they reference. The frontend groups `rows` by sandbox (for the per-sandbox table) or by day (for the chart) and labels them via `sandboxes`.
  - `rows` SandboxDailyUsage[], required
    - `day` string, date-time, required — UTC midnight of the day this usage falls in.
    - `disk_mib_seconds` number, double, required — Σ(overlap_secs × disk_mib) for this sandbox on this day — provisioned writable disk billed on the same GiB-seconds basis while the sandbox runs.
    - `mem_mib_seconds` number, double, required — Σ(overlap_secs × mem_mib) for this sandbox on this day.
    - `sandbox_id` string, uuid, required
    - `vcpu_seconds` number, double, required — Σ(overlap_secs × vcpus) for this sandbox on this day.
  - `sandboxes` SandboxIdentity[], required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required

## Other responses

- `401` — Unauthorized

---

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