> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stats • AI Agents Framework

> get_stats: Get execution statistics.

# get\_stats

<div className="flex items-center gap-2">
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**AgentScheduler**](../classes/AgentScheduler) class in the [**agent\_scheduler**](../modules/agent_scheduler) module.

Get execution statistics.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def get_stats() -> Dict[str, Any]
```

### Returns

<ResponseField name="Returns" type="Dict[str, Any]">
  Dictionary with execution stats. Fields:

  * `is_running` (`bool`) — Whether the scheduler is currently running.
  * `total_executions` (`int`) — Total number of execution attempts.
  * `successful_executions` (`int`) — Number of successful executions.
  * `failed_executions` (`int`) — Number of failed executions.
  * `success_rate` (`float`) — Success percentage (0–100).
  * `total_cost_usd` (`float`) — Running total cost in USD (4 dp).
  * `remaining_budget` (`float | None`) — `max_cost - total_cost_usd`, or `None` if `max_cost` is disabled.
  * `runtime_seconds` (`float`) — Seconds since `start()` was called.
  * `cost_per_execution` (`float`) — `total_cost_usd / total_executions`, rounded to 4 dp.
  * `delivered_deliveries` (`int`) — Runs whose delivery reached the target ([PR #4476](https://github.com/MervinPraison/PraisonAI/pull/4476)).
  * `undelivered_deliveries` (`int`) — Runs whose delivery failed and was surfaced via `on_failure` ([PR #4476](https://github.com/MervinPraison/PraisonAI/pull/4476)).
</ResponseField>

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai/praisonai/agent_scheduler.py#L242">
  `praisonai/agent_scheduler.py` at line 242
</Card>