---
title: "GET /v1/orgs/:slug/billing/usage — live cost estimate (subscription + overage) for the current period, priced from our own meter."
method: GET
path: "/v1/orgs/{slug}/billing/usage"
tags: ["billing"]
---

# GET /v1/orgs/:slug/billing/usage — live cost estimate (subscription + overage) for the current period, priced from our own meter.

`GET /v1/orgs/{slug}/billing/usage`

## Path parameters

- `slug` string, required

## Response `200`

Cost estimate for the current period

- UsageSummary — Usage summary from the billing provider.
  - `daily` UsageDailyPoint[] — Per-day metered quantities for charting. One entry per (day, metric). Empty when no daily series is available (e.g. provider error).
    - `date` string, date-time, required — Start of the day window (UTC).
    - `metric` string, required — Billable-metric name this quantity belongs to.
    - `quantity` number, double, required
  - `line_items` UsageLineItem[], required — Period-aggregated breakdown — one entry per billable metric / charge.
    - `amount_cents` integer, required
    - `name` string, required
    - `quantity` number, double, required
    - `unit` string, required
  - `period_end` string, date-time, required
  - `period_start` string, date-time, required
  - `projected_spend_cents` integer — End-of-period spend projection: `total_cents` linearly extrapolated over the billing period. Equals `total_cents` when the period can't be extrapolated (no future end, or zero elapsed). Never below `total_cents`.
  - `storage_gib` number, double, nullable — Current durable-storage usage (GiB) for the org, from the latest hourly reading. `None` when storage hasn't been sampled (juicefs-ops disabled or no volumes). Drives the storage allowance bar; cost is in `line_items`.
  - `total_cents` integer, 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)