# InteractionProcessTokenUsage

The tokens one agent turn of an interaction run used: the breakdown by kind (input, output, cache, reasoning), the provider and model that served it, the agent, and the key it ran on.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `turnId` | `uuid` | The record's own id. A turn that moved to another key or model part-way has one record for each, and a summary of the conversation has its own, so don't treat it as an id for the turn. |
| `date` | `datetime` | When the call completed (UTC). |
| `provider` | `string` | The provider that served the call, such as `Anthropic` or `OpenAi`. |
| `model` | `string` | The model used for the call. |
| `agentName` | `string` | The participant whose turn used the tokens. |
| `agentId` | `uuid \| null` | The agent that made the call, when it may differ from the participant's own: a router's choice takes the turn, and the routing call itself is the router's. Null for Maitento's own work, such as summarising the conversation or memory. |
| `usages` | [`InteractionTokenUsageItem`](https://docs.maitento.com/reference/types/interaction-token-usage-item.md)`[]` | The tokens used, by kind: `input`, `output`, `cache_read`, `cache_creation_5m`, `cache_creation_1h` and `reasoning`. Added to as the turn goes. |
| `finished` | `boolean` | True once the turn has completed. False while it is still going; a record left false means the turn was cut off, and its counts are what was recorded before that. |
| `credentialId` | `string \| null` | The `credentialId` of the key that served the turn, `maitento-fallback` for Maitento's own key, or null when no key applies (such as a self-hosted model). |
| `isOwnLicense` | `boolean` | True when the turn ran on a key of your own; false for Maitento's own key, or when unknown. |
| `tier` | `string \| null` | The pricing tier of the call, for a model priced in tiers. Null when there is none. |

## Example

```json
{
  "turnId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "date": "2026-10-26T12:00:00.0000000Z",
  "provider": "...",
  "model": "...",
  "agentName": "...",
  "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "usages": [
    {
      "type": "...",
      "count": 0
    }
  ],
  "finished": false,
  "credentialId": "...",
  "isOwnLicense": false,
  "tier": "..."
}
```

## Where it's used

- Inside [`InteractionProcess`](https://docs.maitento.com/reference/types/interaction-process.md)
- Inside [`InteractionProcessWithDetails`](https://docs.maitento.com/reference/types/interaction-process-with-details.md)
- Inside [`NightWeaving`](https://docs.maitento.com/reference/types/night-weaving.md)