Skip to content
Browserberg Browserberg

Usage API reference

GET /v1/usage: metered consumption over a window as totals and UTC day buckets, in-flight sessions and the included quota. Read-only; the meter has one writer.

Last updated:

GET /v1/usage

Metered consumption. `from`/`to` bound the window (ISO instant or date, `to` exclusive, at most 92 days); defaults are the first of the current UTC month and now.

Response

Name Type Description
from, to timestamp The window actually used, as ISO instants.
totals.browser_minutes number Minutes of ready browser time for sessions that ENDED in the window.
totals.task_executions number Finished task and workflow runs.
totals.gateway_tokens number Input plus output tokens through the inference gateway.
totals.stored_artifacts number The daily holdings sample: profiles, credentials and reserved pool browsers, summed.
days[] object `date` (`YYYY-MM-DD`, UTC) plus the four dimensions; every day in the window, zero-filled.
inFlight.openSessions integer Sessions still open at the time of the call.
inFlight.estimatedMinutes number Their minutes so far, from creation. Not in `totals` until they end.
included.browserHours number or null Hours your plan includes, or null.
included.executions number or null Executions your plan includes, or null.

Read it

BASE="https://browserberg.com"
AUTH="Authorization: Bearer $BROWSERBERG_API_KEY"

# The current UTC month by default; from/to bound a window of at most 92 days.
curl -s "$BASE/v1/usage" -H "$AUTH" \
  | python3 -c 'import json,sys; u=json.load(sys.stdin); print("window:", u["from"], "->", u["to"]); print("totals:", json.dumps(u["totals"])); print("days:", len(u["days"]), "open sessions:", u["inFlight"]["openSessions"]); print("included:", json.dumps(u["included"]))'