search
Sign UpSupported Devices
githubEdit

Get an Event

Returns a specified event. This endpoint returns the same event that would be sent to a webhookarrow-up-right, but it enables you to retrieve an event that already took place.

Returns a specified event by ID.

Code:

await seam.events.get({ event_id: "ed3adbb8-bbe1-4033-a35a-710d44322bd8" });

Output:

{
  "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"
}
chevron-rightAuthentication Methodshashtag

  • API key

  • Client session token

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

To learn more, see Authenticationarrow-up-right.

hashtag
Request Parameters

device_id String

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

event_id String

Unique identifier for the event that you want to get.

event_type String

Type of the event that you want to get.

hashtag
Response

circle-check

Returns: event

hashtag
Examples

hashtag
Get an event by event type

Returns a specified event, using the event type.

Code:

Output:

hashtag
Get an event by device ID

Returns a specified event by device ID.

Code:

Output:

PreviousEventsNextList Events

Last updated

Was this helpful?