v1

latestOpenAPI 3.0.02026-08-042710098.2 KB
events

List access control events

Returns events emitted by access control devices: card scans (card_reader_event), grant/deny decisions (access_control_event), REX presses (rex_event), door-held-open alarms (door_held_open_event), battery alerts, and so on. Use the filters to narrow down by door, cardholder, event type, or time window. Pagination uses the same page + limit + has_more shape as every other developer-API list endpoint.

The per-event details object carries event-type-specific data (card_id, access_decision_reason, etc.). Treat it defensively: new keys may appear in future event types.

get/v1/access-control/events

Query parameters

start_timestring date-time

RFC3339 inclusive lower bound on timestamp.

end_timestring date-time

RFC3339 inclusive upper bound on timestamp.

door_idsinteger[]

Repeat to filter to events emitted at specific doors.

cardholder_idsinteger[]

Repeat to filter to events for specific cardholders.

event_typesstring[]

Repeat to filter to a subset of event types.

pageinteger

1-indexed page number.

limitinteger

Maximum events per page (capped at 100).

Response

Successful Response

has_moreboolean required

True if a further page beyond page exists.