How Sandbox Cost Works

import json
from boxrouter import BoxRouter

with BoxRouter() as client:
    box = client.sandboxes.create(lifetime_seconds=300)
    try:
        print("sandbox:", box.id, flush=True)
    finally:
        box.destroy()

    sandbox = client.api.sandboxes.get(box.id)
    print(sandbox.cost.label)
    total = sandbox.cost.total
    print("total:", json.dumps(total.to_dict() if total is not None else None, indent=2))
    print(*sandbox.cost.held_back_by, sep="\n")

import { BoxRouter } from '@boxrouter/sdk';

await using client = new BoxRouter();
let sandboxId: string;
{
  await using box = await client.sandboxes.create({ lifetime_seconds: 300 });
  sandboxId = box.id;
  console.log('sandbox:', sandboxId);
}

const sandbox = await client.api.sandboxes.get({ path: { sandbox_id: sandboxId } });
console.log(sandbox.cost.label);
console.log('total:', JSON.stringify(sandbox.cost.total, null, 2));
console.log(sandbox.cost.held_back_by.join('\n'));

(
  set -euo pipefail
  id=$(boxrouter create --lifetime-seconds 300)
  echo "sandbox: $id"
  boxrouter destroy "$id"
  boxrouter get "$id" | jq -r '.cost.label, "total: \(.cost.total | tojson)", .cost.held_back_by[]'
)

import datetime
import json
from boxrouter import BoxRouter

with BoxRouter() as client:
    day = datetime.date(2026, 10, 29)
    report = client.usage.list(from_=day, to=day, group_by="provider")
    print(json.dumps(report.to_dict(), indent=2))

import { BoxRouter } from '@boxrouter/sdk';

const client = new BoxRouter();
try {
  const query = { from: '2026-10-29', to: '2026-10-29', group_by: 'provider' } as const;
  console.log(JSON.stringify(await client.usage.list({ query }), null, 2));
} finally {
  await client.close();
}

boxrouter usage --from 2026-10-29 --to 2026-10-29 --group-by provider