list_access_events
list_access_events
Section titled “list_access_events”List badge-scan / door events with filters.
Side effects: None (read-only).
Returns events whose timestamp falls inside the last hours_back
hours. result filters to "granted" or "denied"; empty
returns both. door_id narrows to one door.
Example
Section titled “Example”list_access_events(hours_back=6, result="denied", limit=20)Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
hours_back | integer | no | 24 | Look-back window in hours. Defaults to 24. |
result | string | no | "" | Optional "granted" or "denied" filter. Empty (default) returns both. |
door_id | string | no | "" | Optional door id filter. Empty returns events across every door. |
limit | integer | no | 100 | Maximum events returned. Defaults to 100. |
controller | string | no | ”default” | Name of the UniFi controller to target. |