Get an Event

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

POST /events/get

JavaScript

Seam SDK

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"
}
*/

200

{
  "ok": true,
  "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": {}
  },
  "message": "<string>"
}

Authorizations

client_sessionapi_keypat_with_workspaceconsole_session_with_workspaceclient_session_with_customer

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

200

application/json

OK

ok · boolean · required

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.

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

Option 38

Option 39

Option 40

Option 41

Option 42

Option 43

Option 44

Option 45

Option 46

Option 47

Option 48

Option 49

Option 50

Option 51

Option 52

Option 53

Option 54

Option 55

Option 56

Option 57

Option 58

Option 59

Option 60

Option 61

Option 62

Option 63

Option 64

Option 65

Option 66

Option 67

Option 68

Option 69

Option 70

Option 71

Option 72

Option 73

Option 74

Option 75

Option 76

Option 77

Option 78

Option 79

Option 80

Option 81

Option 82

Option 83

Option 84

Option 85

Option 86

Option 87

Option 88

Option 89

Option 90

Option 91

Option 92

Option 93

Option 94

Option 95

Option 96

Option 97

Option 98

Option 99

Option 100

Option 101

Option 102

Option 103

Show child attributes

message · string