List Events

List events emitted within your workspace

/events/list

post

/events/list

Authorizations

client_sessionapi_keypat_with_workspaceconsole_session_with_workspace

Body

unstable_offsetnumber · float

sincestring

device_idstring · uuid

acs_system_idstring · uuid

access_code_idstring · uuid

connected_account_idstring · uuid

connect_webview_idstring · uuid

limitnumber · float · default: 500

event_typestring · enum

Options: 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, acs_system.connected, acs_system.added, acs_system.disconnected, acs_credential.deleted, acs_credential.issued, acs_credential.reissued, acs_user.deleted, acs_encoder.added, acs_encoder.removed, acs_access_group.deleted, 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, enrollment_automation.deleted, phone.deactivated

device_idsstring · uuid[]

acs_system_idsstring · uuid[]

access_code_idsstring · uuid[]

event_idsstring · uuid[]

event_typesstring · enum[]

betweenone of[]

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://connect.getseam.com/events/list' \
  --header 'Authorization: Bearer Client Session Token' \
  --header 'Content-Type: application/json' \
  --data '{
    "unstable_offset": 1,
    "since": "text",
    "device_id": "123e4567-e89b-12d3-a456-426614174000",
    "acs_system_id": "123e4567-e89b-12d3-a456-426614174000",
    "access_code_id": "123e4567-e89b-12d3-a456-426614174000",
    "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
    "connect_webview_id": "123e4567-e89b-12d3-a456-426614174000",
    "limit": 500,
    "event_type": "access_code.created",
    "device_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "acs_system_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "access_code_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "event_ids": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "event_types": [
      "access_code.created"
    ],
    "between": [
      "text"
    ]
  }'

200

400

401

200

{
  "ok": true,
  "events": [
    {
      "event_id": "123e4567-e89b-12d3-a456-426614174000",
      "workspace_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-03-05T00:58:28.081Z",
      "occurred_at": "2025-03-05T00:58:28.081Z",
      "access_code_id": "123e4567-e89b-12d3-a456-426614174000",
      "device_id": "123e4567-e89b-12d3-a456-426614174000",
      "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
      "event_type": "access_code.created"
    }
  ]
}

OK

Request

To access events programmatically, use events.list. This endpoint returns the same events that would be sent to a webhook, but events.list enables you to filter or see events that already took place.

Request Body Parameters

Parameter	Type	Description
since	String Optional	Timestamp since when events were generated. You must include since or between.
between	[String, String] Optional	Lower and upper timestamps by which to filter (exclusive interval). You must include since or between.
device_id	String Optional	ID of the devices to include.
device_ids	String[] Optional	IDs of the devices to include.
access_code_id	String Optional	ID of the access code to include.
access_code_ids	String[] Optional	IDs of the access codes to include.
connected_account_id	String Optional	ID of the connected account to include.
connect_webview_id	String Optional	ID of the Connect Webview to include.
event_type	String Optional	Type of events to include.
event_types	String[] Optional	Types of events to include.
limit	Number Optional	Limit of events to return. Default: 500.

Sample Request

JavaScript

await seam.events.list()

/*
[
  {
    event_id: '87b2dcda-90ff-4602-8ccc-efb2f4a3d7c2',
    event_type: 'device.low_battery',
    created_at: '2022-08-24T11:23:49.459Z',
    device_id: 'a83690b2-2b70-409a-9a94-426699b84c97',
    workspace_id: 'f97073eb-c003-467a-965b-e6dba3a0131d',
    battery_level: 0.48
  },
  {
    event_id: '2fc8d1bc-7b4d-4960-9aa4-7e6bf5dc5848',
    event_type: 'device.low_battery',
    created_at: '2022-08-24T11:23:49.335Z',
    device_id: 'a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4',
    workspace_id: 'f97073eb-c003-467a-965b-e6dba3a0131d',
    battery_level: 0.48
  }
]
*/

Python

seam.events.list()

# [
#     Event(
#         event_id="87b2dcda-90ff-4602-8ccc-efb2f4a3d7c2",
#         event_type="device.low_battery",
#         created_at="2022-08-24T11:23:49.459Z",
#         device_id="a83690b2-2b70-409a-9a94-426699b84c97",
#         workspace_id="f97073eb-c003-467a-965b-e6dba3a0131d",
#         battery_level=0.48,
#     )
# ]

Ruby

seam.events.list

# [<Seam::Event:0x007cd58
#   event_id="87b2dcda-90ff-4602-8ccc-efb2f4a3d7c2",
#   event_type="device.low_battery",
#   created_at="2022-08-24T11:23:49.459Z",
#   device_id="a83690b2-2b70-409a-9a94-426699b84c97",
#   workspace_id="f97073eb-c003-467a-965b-e6dba3a0131d",
#   battery_level=>0.48>]

PHP

$events = $seam->events->list();

echo json_encode($events)
/*
[
  {
    event_id: '87b2dcda-90ff-4602-8ccc-efb2f4a3d7c2',
    event_type: 'device.low_battery',
    created_at: '2022-08-24T11:23:49.459Z',
    device_id: 'a83690b2-2b70-409a-9a94-426699b84c97',
    workspace_id: 'f97073eb-c003-467a-965b-e6dba3a0131d',
    battery_level: 0.48
  },
  {
    event_id: '2fc8d1bc-7b4d-4960-9aa4-7e6bf5dc5848',
    event_type: 'device.low_battery',
    created_at: '2022-08-24T11:23:49.335Z',
    device_id: 'a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4',
    workspace_id: 'f97073eb-c003-467a-965b-e6dba3a0131d',
    battery_level: 0.48
  }
]
*/

Response

Returns an events array.

Sample Response

JSON

{
  "events": [
    {
      "event_id": "87b2dcda-90ff-4602-8ccc-efb2f4a3d7c2",
      "event_type": "device.low_battery",
      "created_at": "2022-08-24T11:23:49.459Z",
      "device_id": "a83690b2-2b70-409a-9a94-426699b84c97",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "battery_level": 0.48
    },
    {
      "event_id": "2fc8d1bc-7b4d-4960-9aa4-7e6bf5dc5848",
      "event_type": "device.low_battery",
      "created_at": "2022-08-24T11:23:49.335Z",
      "device_id": "a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "battery_level": 0.48
    },
    {
      "event_id": "c99b497b-5ff6-4658-854a-4ee694d35355",
      "event_type": "device.low_battery",
      "created_at": "2022-08-24T11:23:49.150Z",
      "device_id": "65803a1c-866b-45ed-94d5-496b40e4cc4d",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d",
      "battery_level": 0.48
    },
    {
      "event_id": "e52e2527-c905-43e5-b84a-87122b64cdda",
      "event_type": "device.connected",
      "created_at": "2022-08-24T11:14:37.119Z",
      "device_id": "a83690b2-2b70-409a-9a94-426699b84c97",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d"
    },
    {
      "event_id": "5d9dce4c-9119-4888-acd6-42044c9740b0",
      "event_type": "device.connected",
      "created_at": "2022-08-24T11:14:36.981Z",
      "device_id": "a3f30bd2-f6d7-4bad-ba89-1bad3bf1bce4",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d"
    },
    {
      "event_id": "fea998c1-e2c7-454d-9173-8a85726aff75",
      "event_type": "device.connected",
      "created_at": "2022-08-24T11:14:36.796Z",
      "device_id": "65803a1c-866b-45ed-94d5-496b40e4cc4d",
      "workspace_id": "f97073eb-c003-467a-965b-e6dba3a0131d"
    }
  ],
  "ok": true
}