List history
Returns the router-improvement time-series.
GET /v1/ai/router/history
| Address | https://api.hanzo.ai/v1/ai/router/history |
| Method | GET |
| Operation | get_ai_router_history |
| Auth | Authorization: Bearer $HANZO_API_KEY |
Returns the router-improvement time-series. Two scopes, one route, mirroring /v1/ai/router/stats:
- ?scope=platform — PUBLIC-safe aggregate over ALL orgs, no authentication. Emits the daily reward/cost-saved/adoption series (task mix included, model ids NOT) and the retrain timeline. This is what world.hanzo.ai polls.
- default (org scope) — requires a signed-in principal, scoped to the caller's OWN org (a super admin may pass ?org= to target another or "" for all).
Window: ?days=N (default 30, capped at 90). Aggregates only.
Request
GET /v1/ai/router/history takes no parameters and no body — the credential is the whole request.
Response
| Status | Body | Meaning |
|---|---|---|
200 | Success. | |
401 | — | No credential, or one this service does not accept. |
403 | — | A valid credential that may not do this. |
200 body — 35 fields.
| Field | In | Type | Always | Description |
|---|---|---|---|---|
data | body | any | — | The operation's own result. |
data2 | body | any | — | A second result the operation defines, when it has one. |
msg | body | string | yes | Empty on success, the reason on failure. |
status | body | string | yes | One of ok, error. |
data.daily | body | ai.HistoryDay[] | — | |
data.daily[].by_task | body | object | — | |
data.daily[].by_task.* | body | integer | — | |
data.daily[].cost_saved_index | body | number | — | |
data.daily[].cumulative_cost_saved | body | number | — | |
data.daily[].date | body | string | — | |
data.daily[].events | body | integer | — | |
data.daily[].learned_share | body | number | — | |
data.daily[].reward_rate | body | number | — | |
data.daily[].rewarded_events | body | integer | — | |
data.retrains | body | ai.HistoryRetrain[] | — | |
data.retrains[].date | body | string | — | |
data.retrains[].events | body | integer | — | |
data.retrains[].gate_base | body | number | — | |
data.retrains[].gate_metric | body | string | — | |
data.retrains[].gate_pass | body | boolean | — | |
data.retrains[].gate_value | body | number | — | |
data.retrains[].holdout_accuracy | body | number | — | |
data.retrains[].published | body | boolean | — | |
data.retrains[].trained_time | body | string | — | |
data.retrains[].version | body | string | — | |
data.scope | body | string | — | |
data.totals | body | ai.HistoryTotals | — | |
data.totals.cumulative_cost_saved | body | number | — | |
data.totals.days_active | body | integer | — | |
data.totals.events | body | integer | — | |
data.totals.reward_rate | body | number | — | |
data.window | body | ai.HistoryWindow | — | |
data.window.days | body | integer | — | |
data.window.since | body | string | — | |
data.window.until | body | string | — |
Failure carries the platform error shape — see Errors.
Examples
CLI
SDK
HTTP
MCP
hanzo ai router history.ts
.py
.go
.rs
.java
import { Configuration, AiApi } from 'hanzoai';
const api = new AiApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getAiRouterHistory();from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import AiApi
client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = AiApi(client).get_ai_router_history()cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)
resp, _, err := client.AiAPI.GetAiRouterHistory(context.Background()).Execute()
if err != nil {
return err
}use hanzo_client::apis::{configuration::Configuration, ai_api};
let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();
let result = ai_api::get_ai_router_history(&cfg, Default::default()).await?;import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.AiApi;
ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));
var result = new AiApi(client).getAiRouterHistory();curl https://api.hanzo.ai/v1/ai/router/history \
-H "Authorization: Bearer $HANZO_API_KEY"MCP declares no tool for ai — tools/list on https://api.hanzo.ai/v1/mcp names the products it does reach. Use HTTP or an SDK.
Was this page useful?