> For the complete documentation index, see [llms.txt](https://llmvision.gitbook.io/getting-started/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://llmvision.gitbook.io/getting-started/usage/get-events.md).

# Get Events

### Usage

```yaml
action: llmvision.get_events
data:
  start: "2026-03-16 08:00:00"
  end: "2026-03-16 20:00:00"
  cameras: image.front_door_person
  categories: people,vehicles,animals
  labels: person,car,dog
  limit: 100
  include_no_activity: true
```

### Parameter Reference

<table><thead><tr><th width="190.15625">Parameter</th><th width="101">Required</th><th width="240.52734375">Description</th><th width="211.5078125">Default</th></tr></thead><tbody><tr><td><code>start</code></td><td>No</td><td>Only return events that overlap with this start datetime.</td><td></td></tr><tr><td><code>end</code></td><td>No</td><td>Only return events that overlap with this end datetime.</td><td></td></tr><tr><td><code>cameras</code></td><td>No</td><td>Only return events captured by the selected entities.</td><td></td></tr><tr><td><code>categories</code></td><td>No</td><td>Comma-separated list of categories to include.</td><td></td></tr><tr><td><code>labels</code></td><td>No</td><td>Only return events matching one of the selected labels</td><td></td></tr><tr><td><code>limit</code></td><td>No</td><td>Maximum number of events to return.</td><td></td></tr><tr><td><code>include_no_activity</code></td><td>No</td><td>Include events with "no activity" in the title.</td><td></td></tr></tbody></table>