Programmatically retrieve cost and usage metrics for your Blaxel account through the Billing Explorer API, with auth and request examples.
The Billing API is the same data source that powers the Billing Explorer in the Blaxel Console. It returns resource-centric, paginated timeseries of cost and usage for an account over an arbitrary time window, with optional filtering and grouping.Use it to:
pull cost and usage into your own observability stack
build custom dashboards and chargeback reports per workspace, resource type, or individual resource
drive alerting on spend trends
The Billing API is an account-scoped API. Unless you pass workspace= or groupBy=workspace (both restricted to account admins — see Admin-only parameters), the response aggregates across every workspace in the account.
Metrics are not real-time. We aggressively minimize the delay, but usage events flow through a metering pipeline before they become queryable — expect a lag of a few minutes (sometimes longer under load) between a resource running and its cost/usage appearing in the response. Do not use this API for hard real-time enforcement; use it for dashboards, reporting, and alerting.
