list_visitors
list_visitors
Section titled “list_visitors”List every visitor pass on the controller (active and expired).
Side effects: None (read-only).
Returns one record per visitor with id, first_name,
last_name, full_name, email, host_user_id,
valid_from (ms), valid_until (ms), and status.
pass_code is redacted to "[REDACTED]". It is the code that
opens the door, not the record’s identifier — id is, and id
still comes back, so get_visitor and every other lookup still
work. Read the code from the Access UI if you need to reissue it.
Example
Section titled “Example”list_visitors(controller="default")Parameters
Section titled “Parameters”| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
controller |
string |
no | “default” | Name of the UniFi controller to target. |