Skip to main content
To see what this month has cost so far and what credit is left, run instabox usage.

​
Read this month’s cost and credits

To read the same figures over the API, use any key that has machines:read or images:read:
GET /v1/usage answers for your personal workspace, or with a workspace’s API key for that workspace. The MCP tool get_usage returns the same figures. Invoices, payment methods, and receipts are on the billing portal. Open it with instabox workspace billing, or from Account in the dashboard.

​
How the cost is computed

Once an hour the server rates the hour that has ended for every workspace and writes one ledger row per resource. The cost is the sum of this month’s rows. Nothing is estimated on request.
  • Runtime: each paid machine’s vCPUs and GiB of memory times the seconds it was running (not starting, paused, or stopped), at the unit prices on Pricing.
  • Disk: paid plans include disk across all their machines. Beyond that, allocated /data is billed by the second while the machine exists (running, paused, or stopped). The system disk, snapshots, and a paused machine’s saved memory are free. Free plan disk is included.
  • Egress: what the workspace’s machines sent to the internet beyond the plan’s monthly egress, per GiB. Ingress is free.
A free machine is never billed, so a free month is $0.00. An hour is priced at the prices in force then. The month is the calendar month in UTC (periodStart to periodEnd), and the figures cover it up to ratedUntil, so they lag by up to an hour.

​
Usage fields

GET /v1/orgs/{id} (instabox workspace get <name>) returns any workspace you belong to, with the same figures as usage, plus its limits and, while billing is on, its subscription as billing. Any member, any API key scope.
Sandbox.getUsage(id) (GET /v1/machines/{id}/usage) gives a machine’s running seconds this UTC month. Tag machines with metadata and add them up per customer: see the SDK quick start.

Pricing

Plans, included credits, disk and egress, and unit prices.

Limits

Machines, sizes, storage and rate limits per plan.