# GET /v1/harnesses/{harness_id}/stats - Get aggregate usage stats for a harness
Source:
GET
/v1/harnesses/{harness\_id}/stats
Select code samplecURL (shell:curl)
```js
const url = 'https://app.everruns.com/api/v1/harnesses/example/stats';
const options = {method: 'GET'};
try {
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(error);
}
```
```sh
curl --request GET \
--url https://app.everruns.com/api/v1/harnesses/example/stats
```
* Production APIapp.everruns.com/api/v1/harnesses/{harness\_id}/stats
## Parameters
### Path Parameters
**harness\_id**
required
string
Harness ID (prefixed) or name
## Responses
### 200
Harness aggregate stats
Media typeapplication/json
Response body for resource stats.
object
**active\_session\_count**
required
Sessions in a running state right now.
integer format: int64
**avg\_session\_duration\_ms**
Average session duration in milliseconds. `None` when `session_count` is 0.
integer | null format: int64
**execution\_count**
required
Total number of agent executions (turns) recorded across all sessions for this resource.
integer format: int64
**first\_session\_at**
Timestamp of the first session for this resource (RFC 3339). `None` if no sessions exist.
string | null format: date-time
**idle\_session\_count**
required
Sessions in an idle state right now (created but no recent activity).
integer format: int64
**last\_execution\_at**
Timestamp of the most recent execution (turn) for this resource (RFC 3339). `None` if no executions exist.
string | null format: date-time
**last\_session\_at**
Timestamp of the most recent session for this resource (RFC 3339). `None` if no sessions exist.
string | null format: date-time
**session\_count**
required
Total number of sessions ever created for this resource.
integer format: int64
**started\_session\_count**
required
Sessions that have started at least one turn.
integer format: int64
**total\_actual\_cost\_usd**
required
Cumulative provider-reported actual cost in USD across all sessions (e.g. OpenRouter’s `usage.cost`). Excludes generations with no reported cost.
number format: double
**total\_cache\_creation\_tokens**
required
Cumulative cache-write tokens across all sessions (charged when first writing a cache entry).
integer format: int64
**total\_cache\_read\_tokens**
required
Cumulative cache-read tokens across all sessions (where the provider supports prompt caching).
integer format: int64
**total\_cost\_usd**
required
Cumulative best-effort cost in USD across all sessions: actual provider cost where reported, otherwise the price-table estimate. Actual takes priority.
number format: double
**total\_estimated\_cost\_usd**
required
Cumulative price-table estimated cost in USD across all sessions. Excludes generations with no profile cost data.
number format: double
**total\_input\_tokens**
required
Cumulative LLM input tokens billed across all sessions.
integer format: int64
**total\_output\_tokens**
required
Cumulative LLM output tokens billed across all sessions.
integer format: int64
**total\_session\_duration\_ms**
required
Cumulative session wall-clock duration in milliseconds across all sessions.
integer format: int64
**waiting\_for\_tool\_results\_session\_count**
required
Sessions currently paused waiting for client-side tool results.
integer format: int64
##### Example
```json
{
"active_session_count": 7,
"avg_session_duration_ms": 20858,
"execution_count": 14206,
"first_session_at": "2026-01-04T11:23:00Z",
"idle_session_count": 23,
"last_execution_at": "2026-05-27T15:24:42Z",
"last_session_at": "2026-05-27T15:24:00Z",
"session_count": 1842,
"started_session_count": 1810,
"total_actual_cost_usd": 31.07,
"total_cache_creation_tokens": 412005,
"total_cache_read_tokens": 5234122,
"total_cost_usd": 42.18,
"total_estimated_cost_usd": 40.55,
"total_input_tokens": 18457321,
"total_output_tokens": 2184109,
"total_session_duration_ms": 38421500,
"waiting_for_tool_results_session_count": 2
}
```
### 403
Forbidden
Media typeapplication/json
Standard error response.
Wire shape is [RFC 9457 Problem Details](https://www.rfc-editor.org/rfc/rfc9457): every error response includes `title` and `status`, and may include `detail`, `code`, `allowed_actions`, `retry_after_seconds`, `instance`, and `type`. The content type is rewritten to `application/problem+json` with the `application/problem+json` content type.
object
**allowed\_actions**
Recovery actions the caller can take next.
Array\