Get a single past request
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`.
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.
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
Path Parameters
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/requests/string"{ "id": "string", "created": 0, "model": "string", "model_requested": "string", "provider": "string", "prompt_tokens": 0, "completion_tokens": 0, "cost": { "amount": "37.14000000", "currency": "USD" }, "latency_ms": 0, "status": "ok", "key_id": "string", "routing_reason": "string", "routing_level": "string", "fallback_used": true, "attempt_count": 0, "finish_reason": "string"}Get the prepaid balance GET
A standalone, point-in-time balance check — the full breakdown (held, purchased, bonus, signup offer), for a "do I have enough money to fire this batch right now" check before a caller submits a large amount of work. Authenticated and rate-limited like every `/v1` path, but never metered — no balance hold is taken.
Get an aggregate spend/usage summary GET
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`.