Get an Event

await seam.events.get({ event_id: "ed3adbb8-bbe1-4033-a35a-710d44322bd8" }); /* { "connected_account_id": "2e3f4a5b-6c7d-8e9f-0a1b-2c3d4e5f6a7b", "created_at": "2025-06-15T16:54:18.000000Z", "device_id": "3febfdb2-de92-43c1-aba4-640ce8a55a22", "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": "ed3adbb8-bbe1-4033-a35a-710d44322bd8", "event_type": "device.connected", "occurred_at": "2025-06-15T16:54:17.946329Z", "workspace_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d" } */

{ "event": { "access_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "connected_account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "created_at": "2023-11-07T05:31:56Z", "device_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "event_type": "access_code.created", "occurred_at": "2023-11-07T05:31:56Z", "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "connected_account_custom_metadata": {}, "device_custom_metadata": {}, "event_description": "<string>" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

device_id

string<uuid>

Unique identifier for the device that triggered the event that you want to get.

event_id

string<uuid>

Unique identifier for the event that you want to get.

event_type

string

Type of the event that you want to get.

Response

event

object

Represents an event. Events let you know when something interesting happens in your workspace. For example, when a lock is unlocked, Seam creates a lock.unlocked event. When a device's battery level is low, Seam creates a device.battery_low event. See the event object.

Show child attributes

Getting Started

Granting Access

Devices and Systems

Setup

Monitoring

Low-Level APIs

Get an Event

Authorizations

Body

Response