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

# kolena_agents.types.usage

## `UsageRecord`

UsageRecord

### `type`

```python theme={null}
type: StrictStr
```

The kind of Usage Record. `agent_run` for Agent Run charges, `validation` for Validation charges. Agent Run charges include Prompt executions and document processing. Records may be split by cost type or credit grant, so multiple `agent_run` records can share a `run_id`. New values may be added in the future.

### `workspace_id`

```python theme={null}
workspace_id: Optional[StrictInt]
```

### `agent_id`

```python theme={null}
agent_id: Optional[StrictInt]
```

### `run_id`

```python theme={null}
run_id: Optional[StrictInt]
```

### `user`

```python theme={null}
user: StrictStr
```

The user whose activity produced this Usage Record.

### `created`

```python theme={null}
created: datetime
```

ISO 8601 timestamp indicating when this Usage Record was created.

### `credits_used`

```python theme={null}
credits_used: Union[StrictFloat, StrictInt]
```

The credits billed for this record. For a Run's billed total, sum `credits_used` across all pages of `agent_run` records with the same `run_id`, including Prompt re-executions. Filters limit which usage is included.

### `validation_id`

```python theme={null}
validation_id: Optional[StrictInt]
```

## `ListUsageRecordsResponse`

ListUsageRecordsResponse

### `records`

```python theme={null}
records: List[UsageRecord]
```

The fetched page of Usage Records. A single Run can have multiple records.

### `total_pages`

```python theme={null}
total_pages: StrictInt
```

The total number of pages of Usage Records. Use the request arguments `page_number` and `page_size` to control which Usage Records are fetched.

### `page_number`

```python theme={null}
page_number: StrictInt
```

The number of the fetched page.

### `page_size`

```python theme={null}
page_size: StrictInt
```

The page size, i.e. number of Usage Records, fetched.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.