List Events
Returns a list of all events. This endpoint returns the same events that would be sent to a webhook, but it enables you to filter or see events that already took place.
Returns a list of events for a specified device.
Code:
await seam.events.list({
device_id: "b2ebca6c-d6d1-47dd-8dae-e9fa06f060b2",
since: "2025-05-15T00:00:00.000Z",
limit: 10,
});Output:
[
{
"connected_account_id": "2e3f4a5b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
"created_at": "2025-06-15T16:54:18.000000Z",
"device_id": "b2ebca6c-d6d1-47dd-8dae-e9fa06f060b2",
"event_description": "The status of a device changed from offline to online. That is, the device.properties.online property changed from false to true. Note that some devices operate entirely in offline mode, so Seam never emits a device.connected event for these devices.",
"event_id": "6d7e8f9a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"event_type": "device.connected",
"occurred_at": "2025-06-15T16:54:17.946329Z",
"workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
}
]Returns a list of events for a specified device.
Code:
Output:
Returns a list of events for a specified device.
Code:
Output:
Returns a list of events for a specified device.
Code:
Output:
Returns a list of events for a specified device.
Code:
Output:
Returns a list of events for a specified device.
Code:
Output:
Request Parameters
access_code_id String
ID of the access code for which you want to list events.
access_code_ids Array of UUIDs
IDs of the access codes for which you want to list events.
access_grant_id String
ID of the access grant for which you want to list events.
access_grant_ids Array of UUIDs
IDs of the access grants for which you want to list events.
access_method_id String
ID of the access method for which you want to list events.
access_method_ids Array of UUIDs
IDs of the access methods for which you want to list events.
acs_access_group_id String
ID of the ACS access group for which you want to list events.
acs_credential_id String
ID of the ACS credential for which you want to list events.
acs_encoder_id String
ID of the ACS encoder for which you want to list events.
acs_entrance_id String
ID of the ACS entrance for which you want to list events.
acs_system_id String
ID of the access system for which you want to list events.
acs_system_ids Array of UUIDs
IDs of the access systems for which you want to list events.
acs_user_id String
ID of the ACS user for which you want to list events.
between Array of Objects
Lower and upper timestamps to define an exclusive interval containing the events that you want to list. You must include since or between.
connect_webview_id String
ID of the Connect Webview for which you want to list events.
connected_account_id String
ID of the connected account for which you want to list events.
customer_key String
Customer key for which you want to list events.
device_id String
ID of the device for which you want to list events.
device_ids Array of UUIDs
IDs of the devices for which you want to list events.
event_ids Array of UUIDs
IDs of the events that you want to list.
event_type String
Type of the events that you want to list.
event_types Array of Enums
Types of the events that you want to list.
limit Number
Numerical limit on the number of events to return.
since String
Timestamp to indicate the beginning generation time for the events that you want to list. You must include since or between.
space_id String
ID of the space for which you want to list events.
space_ids Array of UUIDs
IDs of the spaces for which you want to list events.
unstable_offset Number
Offset for the events that you want to list.
user_identity_id String
ID of the user identity for which you want to list events.
Response
Returns: Array of events
Examples
List events for a customer
Returns a list of events for a specified customer.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
List events for an access system
Returns a list of events for a specified access system.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
List events for an access code
Returns a list of events for a specified access code.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
List events of a specific type
Returns a list of events of a specified type.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
List events for a connected account
Returns a list of events for a specified connected account.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
List events for a Connect Webview
Returns a list of events for a specified Connect Webview.
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Code:
Output:
Last updated
Was this helpful?