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

## `query`

```python theme={null}
query(
    time_range: Optional[ClientTimeRange] = None,
    filters: Optional[LogFilters] = None,
    page_size: Optional[int] = 100,
    cursor: Optional[str] = None,
) -> ClientQueryAccessLogsResponse
```

Query access logs with optional filtering and pagination.

**Parameters:**

| Name | Type | Description | Default |
| - | - | - | - |
| `time_range` | `Optional[ClientTimeRange]` | Optional time range filter for the logs | `None` |
| `filters` | `Optional[LogFilters]` | Optional filters to apply to the log query | `None` |
| `page_size` | `Optional[int]` | Number of items per page (default: 100, max: 10000) | `100` |
| `cursor` | `Optional[str]` | Pagination cursor for retrieving subsequent pages | `None` |

**Returns:**

| Type | Description |
| - | - |
| `ClientQueryAccessLogsResponse` | Response containing access log events and pagination metadata |


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