Get an aggregate spend/usage summary
Account-level aggregate — total spend, request count, and token count over a date window — merged server-side with a balance snapshot. Authenticated and rate-limited like every `/v1` path, but never metered. Omit both `from` and `to` and the window defaults to the trailing 30 days; the response always echoes back the window actually queried, defaulted or not. For a per-request list instead of an aggregate, see `GET /requests`.
Account-level aggregate — total spend, request count, and token count over a date
window — merged server-side with a balance snapshot. Authenticated and
rate-limited like every /v1 path, but never metered.
Omit both from and to and the window defaults to the trailing 30 days; the
response always echoes back the window actually queried, defaulted or not. For a
per-request list instead of an aggregate, see GET /requests.
Authorization
bearerAuth A ModelBeat API key, prefixed mb_live_, sent as Authorization: Bearer <key>.
Keys are issued in the ModelBeat console and are scoped to one tenant. The
example value used throughout this document
(mb_live_EXAMPLE_NOT_A_REAL_KEY_00000000000000000000) is a placeholder and
will not authenticate.
In: header
Query Parameters
ISO 8601 date, inclusive. Defaults with to to the trailing 30 days if both are omitted.
dateISO 8601 date, exclusive. Defaults with from to the trailing 30 days if both are omitted.
dateResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/usage"{ "total_spend": { "amount": "37.14000000", "currency": "USD" }, "request_count": 0, "token_count": 0, "remaining_balance": { "amount": "37.14000000", "currency": "USD" }, "from": "string", "to": "string"}Get a single past request GET
Look up one request by id. Authenticated and rate-limited like every `/v1` path, but never metered. **`id` must be the `X-Request-Id` response header value from the original request, not the response body's own `id` field.** Same identifier convention as `POST /feedback`.
List the intelligence tiers GET
Lists the values `model` accepts, in the OpenAI `/v1/models` list shape, so a stock OpenAI SDK's `models.list()` works unchanged. Authenticated and rate-limited like every `/v1` path, but never metered — no balance hold is taken. During the private beta this is a tier list, not a model catalogue: it returns `modelbeat-advanced`, `modelbeat-standard` and `modelbeat-fast`, and never a model id. Tier names are ModelBeat's own abstraction over the pool, so listing them discloses no model identity (ADR-0070).