> ## 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.

# client.usage

## `list`

```python theme={null}
list(
    page_number: Optional[int] = None,
    page_size: Optional[int] = None,
    created_gte: Optional[datetime] = None,
    created_lte: Optional[datetime] = None,
    agent_id: Optional[int] = None,
    workspace_id: Optional[int] = None,
    user: Optional[str] = None,
) -> ListUsageRecordsResponse
```

List billed credit usage records for the account.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `page_number` | `Optional[int]` | Index of the page to fetch (default: 0). | `None` |
| `page_size` | `Optional[int]` | Maximum number of records to return (default: 50, max: 1000). | `None` |
| `created_gte` | `Optional[datetime]` | Filter to records created on or after this timestamp (inclusive). | `None` |
| `created_lte` | `Optional[datetime]` | Filter to records created on or before this timestamp (inclusive). | `None` |
| `agent_id` | `Optional[int]` | Filter to records associated with this Agent. | `None` |
| `workspace_id` | `Optional[int]` | Filter to records within this Workspace. | `None` |
| `user` | `Optional[str]` | Filter to records attributed to this user email. | `None` |

**Returns:**

| Type | Description |
| - | - |
| `ListUsageRecordsResponse` | Paginated list of usage records. |


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