Sample Events
Complete JSON examples for every Firehose event type with all fields populated. Use these as a reference when building parsers or data models. The JSON field names shown here match the wire format (camelCase equivalents of the proto snake_case names).
Tip: The OpenAPI spec also contains per-event examples in the response dropdown.
Common Envelope
Every event shares the same EventRecord envelope fields:
| Field | Type | Description |
|---|---|---|
recordUid |
string | Unique event ID — use for deduplication |
recordTimestamp |
int64 | Epoch ms when event was generated |
spacesTenantId |
string | Cisco Spaces tenant ID |
spacesTenantName |
string | Cisco Spaces tenant display name |
partnerTenantId |
string | Partner tenant ID |
eventType |
string | Event category (one of the EventType enum values) |
The remaining field is the event-specific payload, keyed by the camelCase name of the oneof event field.
Wi-Fi Events
DEVICE_LOCATION_UPDATE
Device position update with X/Y coordinates, lat/lng, confidence factor, and the detected SSID.
{
"recordUid": "evt-dlu-001",
"recordTimestamp": 1714450000000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "DEVICE_LOCATION_UPDATE",
"deviceLocationUpdate": {
"device": {
"deviceId": "dev-abc-12345",
"userId": "user-xyz-67890",
"tags": ["vip", "employee"],
"mobile": "+14155551234",
"email": "jdoe@example.com",
"gender": "MALE",
"firstName": "John",
"lastName": "Doe",
"postalCode": "95134",
"optIns": ["EMAIL", "TERMS_AND_CONDITIONS"],
"attributes": [{ "name": "department", "values": ["Engineering"] }],
"macAddress": "AA:BB:CC:DD:EE:01",
"manufacturer": "Apple",
"os": "iOS",
"osVersion": "17.4",
"type": "MOBILE",
"deviceModel": "iPhone 15 Pro",
"dhcpProfileInfo": {
"dcProfileName": "Apple-Device",
"dcDeviceClassTag": "smartphone",
"dcCertaintyMetric": "0.95",
"dcProtocolMap": "DHCP-HTTP"
},
"openRoamingUserId": "or-user-001"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"],
"parent": {
"locationId": "loc-building-001",
"name": "Building A",
"inferredLocationTypes": ["BUILDING"],
"parent": {
"locationId": "loc-campus-001",
"name": "Main Campus",
"inferredLocationTypes": ["CAMPUS"]
},
"sourceLocationId": "src-building-001",
"apCount": 50
},
"sourceLocationId": "src-floor-001",
"floorNumber": 1,
"apCount": 25
},
"ssid": "CorpWiFi-5G",
"rawUserId": "raw-uid-001",
"visitId": "visit-abc-001",
"lastSeen": 1714449990000,
"deviceClassification": "ASSOCIATED",
"mapId": "map-floor1-001",
"xPos": 125.75,
"yPos": 340.20,
"confidenceFactor": 0.92,
"latitude": 37.4220,
"longitude": -122.0841,
"unc": 8.5,
"maxDetectedRssi": -42,
"ipv4": "10.0.1.101",
"ipv6": ["2001:db8::1", "fe80::aabb:ccdd:eeff:0001"]
}
}
DEVICE_PRESENCE
Device lifecycle event — entry, active, inactive, or exit. Includes visit metadata and occupancy analytics.
{
"recordUid": "evt-dp-002",
"recordTimestamp": 1714450010000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "DEVICE_PRESENCE",
"devicePresence": {
"presenceEventType": "DEVICE_ENTRY_EVENT",
"wasInActive": false,
"device": {
"deviceId": "dev-abc-12345",
"macAddress": "AA:BB:CC:DD:EE:01",
"manufacturer": "Apple",
"os": "iOS",
"osVersion": "17.4",
"type": "MOBILE",
"deviceModel": "iPhone 15 Pro"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"],
"parent": {
"locationId": "loc-building-001",
"name": "Building A",
"inferredLocationTypes": ["BUILDING"]
},
"sourceLocationId": "src-floor-001",
"floorNumber": 1,
"apCount": 25
},
"ssid": "CorpWiFi-5G",
"rawUserId": "raw-uid-001",
"visitId": "visit-abc-002",
"daysSinceLastVisit": 3,
"entryTimestamp": 1714450010000,
"entryDateTime": "2025-04-30T10:00:10Z",
"exitTimestamp": 0,
"exitDateTime": "",
"visitDurationMinutes": 0,
"timeZone": "America/Los_Angeles",
"deviceClassification": "ASSOCIATED",
"visitClassification": "NEW_VISITOR",
"activeDevicesCount": 142,
"inActiveDevicesCount": 38,
"occupancyAnalytics": {
"result": "INCLUDE",
"ssid": "INCLUDE",
"manufacturer": "IMPLICIT_INCLUDE",
"userNamePattern": "IMPLICIT_INCLUDE"
}
}
}
USER_PRESENCE
User lifecycle event aggregated across devices. Includes social network info and user counts.
{
"recordUid": "evt-up-003",
"recordTimestamp": 1714450020000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "USER_PRESENCE",
"userPresence": {
"presenceEventType": "USER_ENTRY_EVENT",
"wasInActive": false,
"user": {
"userId": "user-xyz-67890",
"deviceIds": ["dev-abc-12345", "dev-abc-12346"],
"tags": ["vip", "employee"],
"mobile": "+14155551234",
"email": "jdoe@example.com",
"gender": "MALE",
"firstName": "John",
"lastName": "Doe",
"postalCode": "95134",
"attributes": [{ "name": "department", "values": ["Engineering"] }],
"socialNetworkInfo": [
{
"socialNetwork": "FACEBOOK",
"socialHandle": "john.doe.fb",
"facebook": {
"id": "fb-10001",
"firstName": "John",
"lastName": "Doe",
"name": "John M Doe",
"picture": "https://example.com/fb/pic.jpg",
"email": "john@example.com"
}
},
{
"socialNetwork": "LINKEDIN",
"socialHandle": "johndoe-li",
"linkedIn": {
"id": "li-30001",
"firstName": "John",
"lastName": "Doe",
"email": "john@example.com"
}
}
],
"openRoamingUserId": "or-user-001"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"rawUserId": "raw-uid-001",
"visitId": "visit-user-001",
"entryTimestamp": 1714450020000,
"entryDateTime": "2025-04-30T10:00:20Z",
"timeZone": "America/Los_Angeles",
"activeUsersCount": {
"usersWithUserId": 85,
"usersWithoutUserId": 42,
"totalUsers": 127
},
"inActiveUsersCount": {
"usersWithUserId": 12,
"usersWithoutUserId": 8,
"totalUsers": 20
},
"connection": "CONN_WIRELESS"
}
}
PROFILE_UPDATE
Device profile data changed — all profile fields included.
{
"recordUid": "evt-pu-004",
"recordTimestamp": 1714450030000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "PROFILE_UPDATE",
"deviceProfileUpdate": {
"deviceId": "dev-abc-12345",
"userId": "user-xyz-67890",
"tags": ["vip", "employee"],
"mobile": "+14155551234",
"email": "jdoe@example.com",
"gender": "MALE",
"firstName": "John",
"lastName": "Doe",
"postalCode": "95134",
"optIns": ["EMAIL", "TERMS_AND_CONDITIONS", "MOBILE_NUMBER"],
"attributes": [
{ "name": "department", "values": ["Engineering"] },
{ "name": "role", "values": ["Staff", "Developer"] }
],
"macAddress": "AA:BB:CC:DD:EE:01",
"manufacturer": "Apple",
"os": "iOS",
"osVersion": "17.4",
"type": "MOBILE",
"deviceModel": "iPhone 15 Pro",
"dhcpProfileInfo": {
"dcProfileName": "Apple-Device",
"dcDeviceClassTag": "smartphone",
"dcCertaintyMetric": "0.95",
"dcProtocolMap": "DHCP-HTTP"
},
"openRoamingUserId": "or-user-001"
}
}
DEVICE_COUNT
Aggregated device count at a location, emitted at 1-minute intervals.
{
"recordUid": "evt-dc-005",
"recordTimestamp": 1714450040000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "DEVICE_COUNT",
"deviceCounts": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"associatedCount": 142,
"estimatedProbingCount": 320,
"probingRandomizedPercentage": 72.5,
"associatedDelta": 5,
"probingDelta": -3,
"estimatedDensity": 0.85,
"estimatedCapacityPercentage": 62.3,
"userCount": 110,
"wirelessUserCount": 95,
"wiredUserCount": 15,
"rfidTagCount": 28,
"bleTagCount": 45
}
}
DEVICE_ASSOCIATION
Device associated or disassociated with the network.
{
"recordUid": "evt-da-006",
"recordTimestamp": 1714450050000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "DEVICE_ASSOCIATION",
"deviceAssociation": {
"event": "ASSOCIATE",
"device": {
"deviceId": "dev-abc-12345",
"macAddress": "AA:BB:CC:DD:EE:01",
"manufacturer": "Apple",
"os": "iOS",
"type": "MOBILE"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"ssid": "CorpWiFi-5G",
"rawUserId": "raw-uid-001",
"ipv4": "10.0.1.101",
"ipv6": ["2001:db8::1"],
"deviceClassification": "ASSOCIATED",
"occupancyAnalytics": {
"result": "INCLUDE",
"ssid": "INCLUDE",
"manufacturer": "IMPLICIT_INCLUDE",
"userNamePattern": "IMPLICIT_INCLUDE"
}
}
}
WIFI_DEVICE_UPDATE
Wi-Fi device update with last-seen time and RSSI.
{
"recordUid": "evt-wdu-007",
"recordTimestamp": 1714450060000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "WIFI_DEVICE_UPDATE",
"wifiDeviceUpdate": {
"clientMac": "AA:BB:CC:DD:EE:01",
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"lastSeen": 1714450055000,
"maxDetectedRssi": -38,
"apMac": "00:11:22:33:44:55"
}
}
DEVICE_RSSI_UPDATE
Device RSSI measurements from multiple APs, including CCX tag payloads.
{
"recordUid": "evt-dru-008",
"recordTimestamp": 1714450070000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "DEVICE_RSSI_UPDATE",
"deviceRssiUpdate": {
"rssiNotification": {
"macAddress": "AA:BB:CC:DD:EE:01",
"transmitPower": 20,
"apRssiMeasurements": [
{
"apMacAddress": "00:11:22:33:44:55",
"ifSlotId": 1,
"bandId": 2,
"antennaId": 0,
"rssi": -42,
"timestamp": 1714450069000
},
{
"apMacAddress": "00:11:22:33:44:66",
"ifSlotId": 0,
"bandId": 1,
"antennaId": 1,
"rssi": -55,
"timestamp": 1714450069500
}
],
"ccxTagPayloadList": [
{
"timestamp": 1714450069000,
"fragmentNumber": 0,
"sequenceNumber": 1,
"data": "SGVsbG8gV29ybGQ="
}
]
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
}
}
}
NETWORK_TELEMETRY
Network health and performance telemetry, including per-band availability and AP telemetry.
{
"recordUid": "evt-nt-009",
"recordTimestamp": 1714450080000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "NETWORK_TELEMETRY",
"networkTelemetry": {
"networkHealth": {
"networkAvailability": [
{
"numOfTests": 100,
"numOfSuccess": 97,
"successPercentage": 97.0,
"numOfDnsLookup": 50,
"numOfDnsLookupSuccess": 49,
"dnsLookupSuccessPercentage": 98.0,
"band": "2.4GHz"
},
{
"numOfTests": 100,
"numOfSuccess": 99,
"successPercentage": 99.0,
"band": "5GHz"
}
],
"apTelemetries": [
{ "apTelemetryType": "CLIENTS_PER_AP", "average": 12.5, "min": 2, "max": 30 },
{ "apTelemetryType": "SNR", "average": 35.2, "min": 18, "max": 50 },
{ "apTelemetryType": "CHANNEL_UTILIZATION", "average": 42.1, "min": 10, "max": 85 },
{ "apTelemetryType": "RSSI", "average": -48.3, "min": -72, "max": -25 }
]
},
"networkPerformance": [
{
"avgUploadBandwidthMbps": 45.6,
"avgDownloadBandwidthMbps": 120.3,
"avgPacketLossPercentage": 0.5,
"avgRttMs": 12,
"avgDnsLookupTimeMs": 8,
"band": "5GHz",
"jitter": 2.3,
"mos": 4.2
}
],
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
}
}
}
NETWORK_STATUS_UPDATE
Connector or controller status change. The payload varies by deviceType.
Connector status:
{
"recordUid": "evt-nsu-010a",
"recordTimestamp": 1714450090000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "NETWORK_STATUS_UPDATE",
"networkStatusUpdate": {
"deviceType": "NDT_CONNECTOR",
"status": "NDS_CONNECTED",
"lastHeard": 1714450085000,
"connectorInfo": {
"id": "connector-001",
"name": "SJ-Connector-Primary",
"ipAddress": "10.0.0.10",
"ovaVersion": "3.5.2",
"dockerVersion": "24.0.7"
}
}
}
Controller status:
{
"recordUid": "evt-nsu-010b",
"recordTimestamp": 1714450091000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "NETWORK_STATUS_UPDATE",
"networkStatusUpdate": {
"deviceType": "NDT_CONTROLLER",
"status": "NDS_ACTIVE",
"lastHeard": 1714450090000,
"controllerInfo": {
"id": "wlc-001",
"name": "SJ-WLC-9800",
"ipAddress": "10.0.0.20",
"version": "17.9.4",
"connectorId": "connector-001",
"connectorName": "SJ-Connector-Primary",
"type": "CATALYST_9800"
}
}
}
IoT Events
IOT_TELEMETRY
IoT device telemetry including temperature, humidity, accelerometer, air quality, battery, iBeacon, Eddystone, CCX data, and more. This is one of the richest event payloads.
{
"recordUid": "evt-iot-011",
"recordTimestamp": 1714450100000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "IOT_TELEMETRY",
"iotTelemetry": {
"deviceInfo": {
"deviceType": "IOT_BLE_DEVICE",
"deviceId": "iot-dev-001",
"deviceMacAddress": "11:22:33:44:55:66",
"group": ["warehouse-sensors", "temp-monitors"],
"deviceName": "Temp Sensor A1",
"firmwareVersion": "2.1.4",
"manufacturer": "Cisco Meraki",
"deviceModel": "MT10"
},
"detectedPosition": {
"xPos": 50.0,
"yPos": 120.5,
"latitude": 37.4219,
"longitude": -122.0840,
"confidenceFactor": 0.88,
"mapId": "map-floor1-001",
"locationId": "loc-floor-001",
"lastLocatedTime": 1714450095000,
"computeType": "CT_RSSI"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"temperature": { "temperatureInCelsius": 23.5, "rawTemperature": 23.48 },
"accelerometer": { "x": 0.02, "y": -0.01, "z": 9.81, "lastMovementTimestamp": 1714449000000, "counter": 42 },
"illuminance": { "value": 350.0, "unit": "LUX" },
"battery": { "value": 85.0, "unit": "PERCENTAGE", "lastRetrieved": 1714440000000 },
"lastUserAction": { "type": "IOT_ACTION_BUTTON_CLICK", "timestamp": 1714448000000 },
"iBeacon": {
"beaconMacAddress": "11:22:33:44:55:66",
"uuid": "f7826da6-4fa2-4e98-8024-bc5b71e0893e",
"major": 100,
"minor": 25,
"advertizedTxPower": -59
},
"eddyStone": {
"beaconMacAddress": "11:22:33:44:55:66",
"uid": "00112233445566778899AABBCCDDEEFF00112233"
},
"humidity": { "humidityInPercentage": 55, "rawHumidity": 5500 },
"airQuality": { "airQualityIndex": 42.5, "airQualityPpb": 150, "airQualityStatus": "GOOD" },
"carbonEmissions": { "co2Ppm": 420 },
"ambientLight": { "valueLx": 350 },
"voltage": { "valueMv": 3300.0 },
"occupancyStatus": { "status": "OCCUPIED" },
"magnetContact": { "contactType": "CLOSED" },
"pushButton": { "action": "PBA_PRESS", "actionButtonLabels": ["Help", "Service"] },
"indoorAirQuality": { "airQualityIndex": 42.5 },
"tvoc": { "valueInPpb": 150 },
"ambientNoise": { "value": 35 },
"massConcentration": { "type": "MCT_PM_2_5", "value": 12, "unit": "ug/m3" },
"maxDetectedRssi": -35
}
}
IOT_USER_ACTION
IoT user action such as a button press.
{
"recordUid": "evt-iua-012",
"recordTimestamp": 1714450110000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "IOT_USER_ACTION",
"iotUserAction": {
"deviceInfo": {
"deviceType": "IOT_BLE_DEVICE",
"deviceId": "iot-dev-002",
"deviceMacAddress": "11:22:33:44:55:77",
"group": ["buttons"],
"deviceName": "Panic Button B1",
"manufacturer": "Cisco Meraki",
"deviceModel": "MT30"
},
"detectedPosition": {
"xPos": 10.0,
"yPos": 5.0,
"latitude": 37.4221,
"longitude": -122.0842,
"confidenceFactor": 0.95,
"mapId": "map-floor1-001",
"locationId": "loc-floor-001",
"computeType": "CT_RSSI"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"actionType": "IOT_ACTION_BUTTON_CLICK",
"actionCount": 2,
"actionTimestamp": 1714450109000,
"actionId": 98765
}
}
BLE_RSSI_UPDATE
BLE device RSSI measurements from multiple APs.
{
"recordUid": "evt-ble-013",
"recordTimestamp": 1714450120000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "BLE_RSSI_UPDATE",
"bleRssiUpdate": {
"rssiNotification": {
"macAddress": "11:22:33:44:55:66",
"apRssiMeasurements": [
{
"apMacAddress": "00:11:22:33:44:55",
"ifSlotId": 1,
"bandId": 2,
"antennaId": 0,
"rssi": -45,
"timestamp": 1714450119000
},
{
"apMacAddress": "00:11:22:33:44:66",
"ifSlotId": 0,
"bandId": 1,
"antennaId": 1,
"rssi": -58,
"timestamp": 1714450119500
}
],
"blePayload": { "timestamp": 1714450119000, "data": "AQIDBAU=" },
"group": ["warehouse-sensors", "temp-monitors"]
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
}
}
}
ASSET_LOCATION_UPDATE
Asset location update from asset locator devices (BLE, RFID, UWB, or Wi-Fi).
{
"recordUid": "evt-alu-020",
"recordTimestamp": 1714450190000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "ASSET_LOCATION_UPDATE",
"assetLocationUpdate": {
"assetInfo": {
"idType": "AIT_EXTERNALLY_PROVIDED",
"id": "asset-wheelchair-042",
"labels": ["wheelchair", "floor-1", "urgent"],
"category": "Medical Equipment",
"department": "Facilities",
"attributes": [
{ "name": "model", "value": "WC-200" },
{ "name": "purchase_year", "value": "2023" }
],
"status": "AS_AVAILABLE"
},
"assetLocatorDeviceInfo": {
"type": "ALDT_BLE",
"macAddress": "AA:11:BB:22:CC:33",
"vendorId": "vendor-tag-001",
"model": "BLE-Tag-Pro"
},
"position": {
"xPos": 75.0,
"yPos": 200.5,
"latitude": 37.4222,
"longitude": -122.0838,
"confidenceFactor": 0.90,
"mapId": "map-floor1-001",
"locationId": "loc-floor-001",
"lastLocatedTime": 1714450185000,
"computeType": "CT_RSSI"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"allComputedPositions": [
{
"xPos": 75.0,
"yPos": 200.5,
"confidenceFactor": 0.90,
"computeType": "CT_RSSI"
},
{
"xPos": 74.8,
"yPos": 201.0,
"confidenceFactor": 0.78,
"computeType": "CT_TDOA"
}
]
}
}
Camera Events
CAMERA_COUNT
Aggregated people count from a Meraki camera at a location.
{
"recordUid": "evt-cc-014",
"recordTimestamp": 1714450130000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "CAMERA_COUNT",
"cameraCounts": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"count": 47,
"countDelta": 3
}
}
RAW_CAMERA_COUNT
Individual camera zone count telemetry.
{
"recordUid": "evt-rcc-015",
"recordTimestamp": 1714450140000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "RAW_CAMERA_COUNT",
"rawCameraCounts": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"cameraId": "cam-meraki-001",
"cameraZoneId": "zone-lobby-001",
"count": 12
}
}
Location Hierarchy Events
LOCATION_CHANGE
Location hierarchy created, updated, or deleted. Includes full location details with map metadata.
{
"recordUid": "evt-lc-016",
"recordTimestamp": 1714450150000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "LOCATION_CHANGE",
"locationHierarchyChange": {
"changeType": "UPDATE",
"location": {
"locationId": "loc-floor-002",
"name": "Floor 2 - Renamed",
"inferredLocationTypes": ["FLOOR"],
"parent": {
"locationId": "loc-building-001",
"name": "Building A",
"inferredLocationTypes": ["BUILDING"]
},
"sourceLocationId": "src-floor-002",
"floorNumber": 2,
"apCount": 20
},
"locationDetails": {
"timeZone": "America/Los_Angeles",
"city": "San Jose",
"state": "California",
"country": "United States",
"category": "Office",
"metadata": [
{ "key": "building_code", "values": ["BLD-A"] },
{ "key": "region", "values": ["West", "US"] }
],
"latitude": 37.4220,
"longitude": -122.0841,
"mapDetails": {
"mapId": "map-floor2-001",
"imageWidth": 2048,
"imageHeight": 1536,
"mimeType": "image/png",
"dimension": {
"length": 80.0,
"width": 60.0,
"height": 3.5,
"offsetX": 0.0,
"offsetY": 0.0
}
}
}
}
}
LOCATION_ANCHOR_UPDATE
Location anchor (BLE beacon) added, updated, or removed.
{
"recordUid": "evt-lau-017",
"recordTimestamp": 1714450160000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "LOCATION_ANCHOR_UPDATE",
"locationAnchorUpdate": {
"changeType": "ADD_UPDATE",
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"locationAnchorInfo": {
"identifier": "anchor-001",
"uuid": "f7826da6-4fa2-4e98-8024-bc5b71e0893e",
"major": 100,
"minor": 25,
"txPower": -59,
"advTxPower": -65,
"frequency": 10,
"xPos": "50.0",
"yPos": "120.0",
"zPos": "2.5",
"latitude": 37.4219,
"longitude": -122.0840,
"mapId": "map-floor1-001"
}
}
}
AP_TOPOLOGY_CHANGE
Access point topology changed on a floor. Includes obstacles, AP details, and map metadata.
{
"recordUid": "evt-apt-018",
"recordTimestamp": 1714450170000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "AP_TOPOLOGY_CHANGE",
"apTopologyChange": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"dimension": { "length": 80.0, "width": 60.0, "height": 3.5 },
"mapDetails": {
"mapId": "map-floor1-001",
"imageWidth": 2048,
"imageHeight": 1536,
"mimeType": "image/png"
},
"obstacles": [
{
"type": "OBSTACLE_TYPE_THICK_WALL",
"attenuation": 15,
"mapCoordinates": [
{ "x": 10.0, "y": 0.0, "z": 0.0 },
{ "x": 10.0, "y": 60.0, "z": 0.0 }
]
}
],
"accessPoints": [
{
"name": "AP-Floor1-01",
"radioMacAddress": "00:11:22:33:44:55",
"ethMacAddress": "00:11:22:33:44:54",
"ipAddress": "10.0.1.50",
"apType": "AP_TYPE_3502I",
"apMode": "AP_MODE_LOCAL",
"mapCoordinate": { "x": 20.0, "y": 30.0, "z": 2.8 },
"apInterfaces": [
{
"band": "BAND_IEEE_802_11_A",
"slotNumber": 1,
"channelNumber": 36,
"txPowerLevel": 4,
"antennaGain": 6,
"antennaMode": "ANTENNA_MODE_OMNI"
}
]
}
],
"floorNumber": 1
}
}
Webex Events
WEBEX_TELEMETRY
Webex device telemetry — people count, presence, noise, air quality, and more.
{
"recordUid": "evt-wt-019",
"recordTimestamp": 1714450180000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "WEBEX_TELEMETRY",
"webexTelemetryUpdate": {
"deviceInfo": {
"deviceId": "webex-dev-001",
"macAddress": "AA:BB:CC:DD:EE:FF",
"ipAddress": "10.0.1.200",
"product": "Cisco Webex Room Kit",
"displayName": "Conf Room 1A - Webex",
"serialNumber": "FCH2345X001",
"softwareVersion": "ce11.9.0",
"workspaceId": "ws-conf-001",
"orgId": "org-cisco-001"
},
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"telemetries": [
{ "peopleCount": 4 },
{ "presence": true },
{ "ambientNoise": 35 },
{ "soundLevel": 42 },
{ "airQuality": 42.5 },
{ "airQualityStatus": "GOOD" },
{ "ambientTemp": 23.5 },
{ "relativeHumidity": 55 },
{ "activeCalls": 1 }
]
}
}
Occupancy Events
SPACE_OCCUPANCY
Space occupancy state — periodic snapshot with peak count, presence, and booking status.
{
"recordUid": "evt-so-021",
"recordTimestamp": 1714450200000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "SPACE_OCCUPANCY",
"spaceOccupancy": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"space": {
"id": "space-conf-001",
"name": "Conference Room 1A",
"floorId": "loc-floor-001",
"type": "ROOM",
"spaceType": {
"isPrivate": true,
"type": "MEETING_ROOM",
"meetingRoom": "MR_MEETING_ROOM"
},
"capacity": 12,
"occupancyType": "BOTH"
},
"windowStartTimestamp": 1714449900000,
"windowStartDateTime": "2025-04-30T09:58:00Z",
"timeZone": "America/Los_Angeles",
"peakPeopleCount": 8,
"peoplePresence": true,
"bookingStatus": true
}
}
SPACE_OCCUPANCY_CHANGE
Space occupancy changed — triggered on people count or presence changes.
{
"recordUid": "evt-soc-022",
"recordTimestamp": 1714450210000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "SPACE_OCCUPANCY_CHANGE",
"spaceOccupancyChange": {
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"space": {
"id": "space-conf-001",
"name": "Conference Room 1A",
"floorId": "loc-floor-001",
"type": "ROOM",
"spaceType": {
"isPrivate": true,
"type": "CLINICAL",
"clinical": "CL_CONSULTATION_ROOM"
},
"capacity": 12,
"occupancyType": "PEOPLE_COUNT"
},
"peopleCount": 6,
"peoplePresence": true,
"bookingStatus": true
}
}
BUILDING_FEATURE
Space (feature) added, updated, or removed on a digital floor map.
{
"recordUid": "evt-bf-023",
"recordTimestamp": 1714450220000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "BUILDING_FEATURE",
"buildingFeature": {
"changeType": "ADD",
"id": "feature-001",
"fid": "fid-conf-001",
"name": "Conference Room 1A",
"location": {
"locationId": "loc-floor-001",
"name": "Floor 1",
"inferredLocationTypes": ["FLOOR"]
},
"mapSourceReference": "autocad-export-v3",
"areaSqFt": 450.75,
"points": [
{ "lng": -122.0842, "lat": 37.4220 },
{ "lng": -122.0840, "lat": 37.4220 },
{ "lng": -122.0840, "lat": 37.4222 },
{ "lng": -122.0842, "lat": 37.4222 }
],
"spaceType": {
"isPrivate": false,
"type": "AMENITY",
"amenity": "AMN_WAITING_AREA"
}
}
}
Activation Events
APP_ACTIVATION
Customer activated the application. Contains activation metadata and configured filters.
{
"recordUid": "evt-aa-024",
"recordTimestamp": 1714450230000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "APP_ACTIVATION",
"appActivation": {
"spacesTenantName": "Acme Corp",
"spacesTenantId": "tenant-abc-123",
"partnerTenantId": "partner-xyz-456",
"name": "My Firehose App",
"referenceId": "ref-app-001",
"instanceName": "production-instance",
"macFilters": ["AA:BB:CC:*", "11:22:33:*"],
"iotGroups": ["warehouse-sensors", "temp-monitors"],
"appId": "app-firehose-001",
"region": "us-west-2"
}
}
System Events
KEEP_ALIVE
Heartbeat sent every ~15 seconds when no other events are available. No event-specific payload.
{
"recordUid": "evt-ka-025",
"recordTimestamp": 1714450240000,
"spacesTenantId": "tenant-abc-123",
"spacesTenantName": "Acme Corp",
"partnerTenantId": "partner-xyz-456",
"eventType": "KEEP_ALIVE"
}