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.
[ {"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" }]
{
"events": [
{
"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"
}
]
}
[
SeamEvent(
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",
)
]
[
{
"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",
},
]
[
[
"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:
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"
}
]
Authentication Methods
API key
Client session token
Personal access token
Must also include the seam-workspace header in the request.
{
"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.
[
{
"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"
}
]
{
"events": [
{
"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"
}
]
}
[
SeamEvent(
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",
)
]
[
{
"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",
},
]
[
[
"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",
],
];
Code:
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.
[
{
"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"
}
]
{
"events": [
{
"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"
}
]
}
[
SeamEvent(
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",
)
]
[
{
"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",
},
]
[
[
"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",
],
];
Code:
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.
[
{
"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"
}
]
{
"events": [
{
"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"
}
]
}
[
SeamEvent(
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",
)
]
[
{
"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",
},
]
[
[
"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",
],
];
Code:
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.