---
type: email
from: Latrache Abdelfettah <notifications@github.com>
subject: [openai/openai-agents-python] `RunResult` missing `.usage` attribute

 in latest OpenAI Agents SDK (Issue #1457)
received: 2026-03-05 10:04:38
date_header: Wed, 13 Aug 2025 09:57:29 -0700
priority: normal
status: awaiting_approval
uid: 27489
---

## Email Content

**From:** Latrache Abdelfettah <notifications@github.com>
**Subject:** [openai/openai-agents-python] `RunResult` missing `.usage` attribute

 in latest OpenAI Agents SDK (Issue #1457)
**Date:** Wed, 13 Aug 2025 09:57:29 -0700

### Body (preview)

LatVAlY created an issue (openai/openai-agents-python#1457)





## Description

I'm using the latest `openai-agents` Python SDK and running an agent successfully with `Runner.run(...)`.  

However, the returned `RunResult` object does not have a `.usage` attribute, even though the documentation suggests it should.



## Code Snippet

```python

base_result = await Runner.run(

    self.agent,

    input=instruction

    context=context,

)



print(base_result.final_output)   # works fine

print(base_result.usage)          # raises AttributeError

````



## Error



```

AttributeError: 'RunResult' object has no attribute 'usage'

```



## Environment



* **openai-agents** version: 0.2.6 

* **Python**: 3.11

* **OS**: (e.g., macOS 14.5 / Ubuntu 22.04)

* **Agent Type**: Custom agent built with `Agent` and run via `Runner.run(...)`



## Expected behavior



The `RunResult` object should contain `.usage` with `input_tokens`, `output_tokens`, and `total_tokens`, as per the documentation/examples.



## Additional context



This is blocking me from tracking token consumption per run.

If `.usage` is not supported in `Runner.run`, please clarify the intended way to retrieve token usage for agent runs.











-- 

Reply to this email directly or view it on GitHub:

https://github.com/openai/openai-agents-python/issues/1457

You are receiving this because you are subscribed to this thread.



Message ID: <openai/openai-agents-python/issues/1457@github.com>

---

## Suggested Actions
- [ ] Reply
- [ ] Archive
- [ ] Escalate
