curl "https://app.runtm.com/api/cloud/sessions/telemetry/agents?days=30" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents scorecard --days 30
{
"days": 30,
"agents": [
{
"agent_id": "a1b2c3d4-0000-0000-0000-000000000000",
"name": "Donna",
"avatar": null,
"avatar_image_url": null,
"sessions": 14,
"turns": 61,
"tokens": {"input": 5150000, "output": 420000, "cache_read": 20500000, "cache_write": 1200000},
"spend_usd": 41.72,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"objective_hit_rate": 0.83,
"tasks": {"weekly-lists": {"runs": 4, "successes": 4}},
"unpriced_runs": 2,
"value_usd": 120.0,
"minutes_returned": 340,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded": false},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
],
"totals": {
"spend_usd": 41.72,
"value_usd": 120.0,
"minutes_returned": 340,
"sessions": 14,
"turns": 61,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"return_multiple": 2.88,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded_agents": []}
},
"parameters": {
"prices_per_mtok": {"claude-sonnet": {"input": 3.0, "output": 15.0}},
"cache_multipliers": {"write_5m": 1.25, "write_1h": 2.0, "read": 0.1}
}
}
Activity
Agent Scorecard
Per-agent performance, spend, and value over a time window
GET
/
api
/
sessions
/
telemetry
/
agents
curl "https://app.runtm.com/api/cloud/sessions/telemetry/agents?days=30" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents scorecard --days 30
{
"days": 30,
"agents": [
{
"agent_id": "a1b2c3d4-0000-0000-0000-000000000000",
"name": "Donna",
"avatar": null,
"avatar_image_url": null,
"sessions": 14,
"turns": 61,
"tokens": {"input": 5150000, "output": 420000, "cache_read": 20500000, "cache_write": 1200000},
"spend_usd": 41.72,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"objective_hit_rate": 0.83,
"tasks": {"weekly-lists": {"runs": 4, "successes": 4}},
"unpriced_runs": 2,
"value_usd": 120.0,
"minutes_returned": 340,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded": false},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
],
"totals": {
"spend_usd": 41.72,
"value_usd": 120.0,
"minutes_returned": 340,
"sessions": 14,
"turns": 61,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"return_multiple": 2.88,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded_agents": []}
},
"parameters": {
"prices_per_mtok": {"claude-sonnet": {"input": 3.0, "output": 15.0}},
"cache_multipliers": {"write_5m": 1.25, "write_1h": 2.0, "read": 0.1}
}
}
The aggregate side of the evaluation loop: for every roster agent, the sessions and turns it ran, token spend, graded runs and objective hit rate, the value returned (from the agent’s
economics), and budget state. Read one run’s verdict with Session Grade; set the rubric with Update Agent.
Required scope: activity:read
Query Parameters
integer
default:"30"
Rolling window in days (max 365). Ignored when
start and end are set.string
Window start (ISO date or datetime).
string
Window end (ISO date or datetime; a bare date means end of that day).
Response
integer
The resolved window length.
array
Show properties
Show properties
string
Roster agent ID.
string
Agent display name.
integer
Sessions the agent ran in the window.
integer
Prompt turns across those sessions.
object
{input, output, cache_read, cache_write} token counts.number
Estimated spend in USD.
integer
Runs the grader has scored.
integer
Graded runs that met the objective.
number
successful_runs / graded_runs.
object
Per-task run and success counts, keyed by the task labels from
economics.number
Value returned, priced from the agent’s
economics.tasks.number
Human minutes returned, priced the same way.
object
{monthly_usd_cap, month_spend_usd, exceeded}.object
Cross-agent totals including
return_multiple (value over spend) and the list of agents over budget.object
The pricing table used: per-model prices per million tokens and cache multipliers.
curl "https://app.runtm.com/api/cloud/sessions/telemetry/agents?days=30" \
-H "Authorization: Bearer runtm_xxx" \
-H "X-Organization-Id: org_abc123"
runtm-api agents scorecard --days 30
{
"days": 30,
"agents": [
{
"agent_id": "a1b2c3d4-0000-0000-0000-000000000000",
"name": "Donna",
"avatar": null,
"avatar_image_url": null,
"sessions": 14,
"turns": 61,
"tokens": {"input": 5150000, "output": 420000, "cache_read": 20500000, "cache_write": 1200000},
"spend_usd": 41.72,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"objective_hit_rate": 0.83,
"tasks": {"weekly-lists": {"runs": 4, "successes": 4}},
"unpriced_runs": 2,
"value_usd": 120.0,
"minutes_returned": 340,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded": false},
"economics": {"budget": {"monthly_usd_cap": 50}}
}
],
"totals": {
"spend_usd": 41.72,
"value_usd": 120.0,
"minutes_returned": 340,
"sessions": 14,
"turns": 61,
"duration_ms": 5400000,
"graded_runs": 12,
"successful_runs": 10,
"return_multiple": 2.88,
"budget": {"monthly_usd_cap": 50, "month_spend_usd": 41.72, "exceeded_agents": []}
},
"parameters": {
"prices_per_mtok": {"claude-sonnet": {"input": 3.0, "output": 15.0}},
"cache_multipliers": {"write_5m": 1.25, "write_1h": 2.0, "read": 0.1}
}
}