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"
}
]
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.
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.
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
.
unstable_offset
Number
Offset for the events that you want to list.
Response
Array of events
{
"connected_account_id": "2e3f4a5b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
"created_at": "2025-06-15T16:54:18.000000Z",
"device_id": "b3c4d5e6-f7a8-49bc-def1-23456789abcd",
"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"
}
Examples
List events for a customer
Returns a list of events for a specified customer.
Code:
await seam.events.list({
customer_ids: ["e387e15f-be27-47ad-881f-4a6fc5460c57"],
between: ["2025-05-15T00:00:00.000Z", "2025-06-20T23:59:59.999Z"],
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"
}
]
List events for an access system
Returns a list of events for a specified access system.
Code:
await seam.events.list({
acs_system_id: "5d92d231-cea4-4ceb-b9f6-1ff9cb9c5099",
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",
"acs_system_id": "5d92d231-cea4-4ceb-b9f6-1ff9cb9c5099",
"event_description": "An access system was connected.",
"event_id": "6d7e8f9a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"event_type": "acs_system.connected",
"occurred_at": "2025-06-15T16:54:17.946329Z",
"workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
}
]
List events for an access code
Returns a list of events for a specified access code.
Code:
await seam.events.list({
access_code_id: "37ba4a46-c9a7-47a2-b761-f63d02acbea4",
since: "2025-05-15T00:00:00.000Z",
limit: 10,
});
Output:
[
{
"access_code_id": "37ba4a46-c9a7-47a2-b761-f63d02acbea4",
"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": "An access code was created.",
"event_id": "6d7e8f9a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"event_type": "access_code.created",
"occurred_at": "2025-06-15T16:54:17.946329Z",
"workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
}
]
List events of a specific type
Returns a list of events of a specified type.
Code:
await seam.events.list({
event_type: "device.connected",
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"
}
]
List events for a connected account
Returns a list of events for a specified connected account.
Code:
await seam.events.list({
connected_account_id: "2e3f4a5b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
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": "A connected account was connected for the first time or was reconnected after being disconnected.",
"event_id": "6d7e8f9a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"event_type": "connected_account.connected",
"occurred_at": "2025-06-15T16:54:17.946329Z",
"workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
}
]
List events for a Connect Webview
Returns a list of events for a specified Connect Webview.
Code:
await seam.events.list({
connect_webview_id: "775bc894-c51a-47e8-b7ac-f92292c62d63",
since: "2025-05-15T00:00:00.000Z",
limit: 10,
});
Output:
[
{
"connect_webview_id": "775bc894-c51a-47e8-b7ac-f92292c62d63",
"connected_account_id": "2e3f4a5b-6c7d-8e9f-0a1b-2c3d4e5f6a7b",
"created_at": "2025-06-15T16:54:18.000000Z",
"event_description": "A Connect Webview login succeeded.",
"event_id": "6d7e8f9a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"event_type": "connect_webview.login_succeeded",
"occurred_at": "2025-06-15T16:54:17.946329Z",
"workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d"
}
]
Last updated
Was this helpful?