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"
  }
]
Authentication Methods
  • API key

  • Client session token

  • Personal access token Must also include the seam-workspace header in the request.

To learn more, see Authentication.

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_ids Array of UUIDs

IDs of the customers 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.

Enum values

Possible enum values:

  • access_code.created

  • access_code.changed

  • access_code.scheduled_on_device

  • access_code.set_on_device

  • access_code.removed_from_device

  • access_code.delay_in_setting_on_device

  • access_code.failed_to_set_on_device

  • access_code.deleted

  • access_code.delay_in_removing_from_device

  • access_code.failed_to_remove_from_device

  • access_code.modified_external_to_seam

  • access_code.deleted_external_to_seam

  • access_code.backup_access_code_pulled

  • access_code.unmanaged.converted_to_managed

  • access_code.unmanaged.failed_to_convert_to_managed

  • access_code.unmanaged.created

  • access_code.unmanaged.removed

  • access_grant.created

  • access_grant.deleted

  • access_grant.access_granted_to_all_doors

  • access_grant.access_granted_to_door

  • access_grant.access_to_door_lost

  • access_method.issued

  • access_method.revoked

  • access_method.card_encoding_required

  • access_method.deleted

  • access_method.reissued

  • acs_system.connected

  • acs_system.added

  • acs_system.disconnected

  • acs_credential.deleted

  • acs_credential.issued

  • acs_credential.reissued

  • acs_credential.invalidated

  • acs_user.created

  • acs_user.deleted

  • acs_encoder.added

  • acs_encoder.removed

  • acs_access_group.deleted

  • acs_entrance.added

  • acs_entrance.removed

  • client_session.deleted

  • connected_account.connected

  • connected_account.created

  • connected_account.successful_login

  • connected_account.disconnected

  • connected_account.completed_first_sync

  • connected_account.deleted

  • connected_account.completed_first_sync_after_reconnection

  • action_attempt.lock_door.succeeded

  • action_attempt.lock_door.failed

  • action_attempt.unlock_door.succeeded

  • action_attempt.unlock_door.failed

  • connect_webview.login_succeeded

  • connect_webview.login_failed

  • device.connected

  • device.added

  • device.converted_to_unmanaged

  • device.unmanaged.converted_to_managed

  • device.unmanaged.connected

  • device.disconnected

  • device.unmanaged.disconnected

  • device.tampered

  • device.low_battery

  • device.battery_status_changed

  • device.removed

  • device.deleted

  • device.third_party_integration_detected

  • device.third_party_integration_no_longer_detected

  • device.salto.privacy_mode_activated

  • device.salto.privacy_mode_deactivated

  • device.connection_became_flaky

  • device.connection_stabilized

  • device.error.subscription_required

  • device.error.subscription_required.resolved

  • device.accessory_keypad_connected

  • device.accessory_keypad_disconnected

  • noise_sensor.noise_threshold_triggered

  • lock.locked

  • lock.unlocked

  • lock.access_denied

  • thermostat.climate_preset_activated

  • thermostat.manually_adjusted

  • thermostat.temperature_threshold_exceeded

  • thermostat.temperature_threshold_no_longer_exceeded

  • thermostat.temperature_reached_set_point

  • thermostat.temperature_changed

  • device.name_changed

  • enrollment_automation.deleted

  • phone.deactivated


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?