Skip to main content
GET
List audit entries

Updated 23 Oct 2026 15:20 · page 9e49255

Authorizations

Authorization
string
header
required

Mint a token from the portal at Settings → API tokens. Send it as Authorization: Bearer avb_... on every request. Query-string tokens are NOT accepted — the URL ends up in access logs.

Query Parameters

action
string

Exact action, e.g. device.update. End with a dot (device.) to match every action on that kind of record.

target_kind
string

Exact kind of record, e.g. device, user, notification_channel.

target_id
string

Matches the primary or the related target, so a device's feed also includes commands sent to it.

actor
string

Exact actor label, as shown in actor.

device_id
string<uuid>

Entries about this device, including commands sent to it.

room_id
string<uuid>

Entries about this room and everything in it: its devices and their commands, its assets, and its Room Readiness runs.

building_id
string<uuid>

Entries about this building, its rooms and everything in them.

location_id
string<uuid>

Entries about this location (site), its buildings, rooms and everything in them. Place filters use each record's current place, so a device moved to another room appears under its new room, history included.

since
string<date-time>

Entries at or after this time (RFC 3339). Use since or last, not both.

until
string<date-time>

Entries before this time (RFC 3339).

last
string

A rolling window instead of since: 15m, 2h, 7d, up to 366d. For example last=15m returns the last 15 minutes.

Example:

"15m"

limit
integer
default:100

Rows per page. Default 100, maximum 500.

Required range: 1 <= x <= 500
cursor
string

Opaque pagination cursor from a previous response's next_cursor. Omit on the first call. Treat this as an opaque string — its shape may change.

Response

Page of audit entries.

data
object[]
required
next_cursor
string | null
required

Pass this back as ?cursor= on the next call. null means this page is the last one.