# RunUsage

> Tracon documentation. Tracon is a .NET package family that adds a control
> plane on Microsoft Agent Framework, published as NuGet packages that run
> inside your own ASP.NET Core application.
>
> Page: https://tracon.dev/http-api/schemas/runusage/
> Summary: OpenAPI request or response schema for RunUsage, including required fields, defaults, constraints, and linked nested types.

[← All HTTP schemas](/http-api/schemas/)

Token usage of a run.

**Shape:** `object`

| Property | Required | Type | Description | Rules |
|---|---|---|---|---|
| `inputTokens` | no | `integer (int64)` | Gets the number of input tokens. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `outputTokens` | no | `integer (int64)` | Gets the number of output tokens. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `totalTokens` | no | `integer (int64)` | Gets the total number of tokens. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `cachedInputTokens` | no | `integer (int64)` | Gets the input tokens that were served from the provider's prompt cache. Counted INSIDE `InputTokens`. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `reasoningTokens` | no | `integer (int64)` | Gets the tokens the model spent on reasoning. Counted INSIDE `OutputTokens`. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `audioInputTokens` | no | `integer (int64)` | Gets the audio input tokens. Counted INSIDE `InputTokens`. | pattern `^-?(?:0\\|[1-9]\d*)$` |
| `audioOutputTokens` | no | `integer (int64)` | Gets the audio output tokens. Counted INSIDE `OutputTokens`. | pattern `^-?(?:0\\|[1-9]\d*)$` |