AWS Events Schema

AWS IoT Events allows you to detect and respond to events fromTrimble IoT devices.

{
  "traceId": "b700ed2d-0b69-45f0-a38a-e6c8d5573c5f",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:10:53.231+0000",
  "topic": "$aws/events/thing/e0e0761f-001c-42a8-9851-07df3f11e080/created",
  "eventType": "created",
  "message": {
    "eventId": "547215d4d210dae78cc545ce0dd83736",
    "versionNumber": 1,
    "groupId": "afe33340-2e50-4222-8c5e-4337ddb2f5e2",
    "timestamp": 1676981453201
  }
}

{
  "traceId": "496ed041-1313-4800-b6c3-a76c8ac38413",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T06:01:25.119+0000",
  "topic": "$aws/events/thing/e0e0761f-001c-42a8-9851-07df3f11e080/deleted",
  "eventType": "deleted",
  "message": {
    "eventId": "ec1334194292fcc69b8320c844f149af",
    "versionNumber": 1,
    "groupId": "afe33340-2e50-4222-8c5e-4337ddb2f5e2",
    "timestamp": 1677045685097
  }
}

{
  "traceId": "84396e57-3adb-4711-93c2-cc4f02da055f",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:21:48.712+0000",
  "topic": "$aws/events/presence/connected/e0e0761f-001c-42a8-9851-07df3f11e080",
  "eventType": "connected",
  "message": {
    "principalIdentifier": "9d4636876e4958ae9029a895176cba736fed774eb4895bb97e76f20d57993770",
    "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
    "ipAddress": "155.63.246.10",
    "eventType": "connected",
    "sessionIdentifier": "c2eadb51-0a53-4042-914f-2b07a5d08d5b",
    "versionNumber": 0,
    "timestamp": 1676982108703
  }
}

{
  "traceId": "6080d000-7445-c037-6e79-3a2ad79907fa",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:23:12.027+0000",
  "topic": "$aws/events/presence/disconnected/e0e0761f-001c-42a8-9851-07df3f11e080",
  "eventType": "disconnected",
  "message": {
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
    "principalIdentifier": "9d4636876e4958ae9029a895176cba736fed774eb4895bb97e76f20d57993770",
    "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
    "clientInitiatedDisconnect": true,
    "eventType": "disconnected",
    "sessionIdentifier": "c2eadb51-0a53-4042-914f-2b07a5d08d5b",
    "versionNumber": 0,
    "timestamp": 1676982192012
  }
}

{
  "traceId": "57cb5018-7b93-1449-08a1-494ac90858a5",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:24:34.321+0000",
  "topic": "$aws/events/subscriptions/subscribed/e0e0761f-001c-42a8-9851-07df3f11e080",
  "eventType": "subscribed",
  "message": {
    "principalIdentifier": "9d4636876e4958ae9029a895176cba736fed774eb4895bb97e76f20d57993770",
    "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
    "eventType": "subscribed",
    "topics": [
      "afe33340-2e50-4222-8c5e-4337ddb2f5e2/gps"
    ],
    "sessionIdentifier": "09480999-2e38-46b7-8821-809279ed3c23",
    "timestamp": 1676982274307
  }
}

{
  "traceId": "32e708db-ebbe-3623-f8c6-6eab9b1fd55e_update-delta",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:48:58.259+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/update/delta",
  "eventType": "update-delta",
  "message": {
    "metadata": {
      "color": {
        "timestamp": 1676983538
      }
    },
    "state": {
      "color": "green"
    },
    "version": 2,
    "timestamp": 1676983738
  }
}

{
  "traceId": "32e708db-ebbe-3623-f8c6-6eab9b1fd55e_update-documents",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:48:58.257+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/update/documents",
  "eventType": "update-documents",
  "message": {
    "previous": {
      "version": 1,
      "metadata": {
        "desired": {
          "color": {
            "timestamp": 1676983538
          }
        }
      },
      "state": {
        "desired": {
          "color": "green"
        }
      }
    },
    "current": {
      "version": 2,
      "metadata": {
        "desired": {
          "color": {
            "timestamp": 1676983538
          }
        },
        "reported": {
          "color": {
            "timestamp": 1676983738
          }
        }
      },
      "state": {
        "desired": {
          "color": "green"
        },
        "reported": {
          "color": "red"
        }
      }
    },
    "timestamp": 1676983738
  }
}

{
  "traceId": "b29fa2da-7d7d-3bd2-8d4d-2c52fa7bef66_update-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-21T12:45:38.593+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/update/accepted",
  "eventType": "update-accepted",
  "message": {
    "metadata": {
      "desired": {
        "color": {
          "timestamp": 1676983538
        }
      }
    },
    "state": {
      "desired": {
        "color": "green"
      }
    },
    "version": 1,
    "timestamp": 1676983538
  }
}

{
  "traceId": "46b373da-b1b5-3bab-92ab-bb512364e781_update-rejected",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-28T11:37:38.460+0000",
  "eventType": "update-rejected",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/update/rejected",
  "message": {
    "message": "Payload contains invalid json",
    "code": 400
  }
}

{
  "traceId": "28acb062-225b-a803-fe8b-e3955f2e88ff_get-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T07:25:25.557+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/get/accepted",
  "eventType": "get-accepted",
  "message": {
    "metadata": {
      "desired": {
        "color": {
          "timestamp": 1676983745
        }
      },
      "reported": {
        "color": {
          "timestamp": 1676983738
        }
      }
    },
    "state": {
      "desired": {
        "color": "green"
      },
      "reported": {
        "color": "red"
      },
      "delta": {
        "color": "green"
      }
    },
    "version": 3,
    "timestamp": 1677050725
  }
}

{
  "traceId": "3cb28e24-d941-922c-204d-dbdb97a3cd83_get-rejected",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-28T12:00:49.960+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/get/rejected",
  "eventType":"get-rejected",
  "message": {
    "message": "No shadow exists with name: 'e0e0761f-001c-42a8-9851-07df3f11e080'",
    "code": 404
  }
}

{
  "traceId": "41194fe8-8798-7b9a-a5b5-bbf9c57fd984_delete-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T07:34:36.389+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/delete/accepted",
  "eventType": "delete-accepted",
  "message": {
    "version": 3,
    "timestamp": 1677051276
  }
}

{
            "traceId": "1b0d76ce-812c-4435-df68-597e2fbcceae_delete-rejected",
            "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
            "receivedUtc": "2023-02-28T11:51:02.508+0000",
            "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/delete/rejected",
            "eventType":"delete-rejected",
            "message": {
                "message": "No shadow exists with name: 'e0e0761f-001c-42a8-9851-07df3f11e080'",
                "code": 404
            }
        }

{
  "traceId": "61ff9ff8-1f8e-0dbf-7fb5-d90c5b7af5fe_mod1-update-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T10:37:15.739+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/update/accepted",
  "eventType": "mod1-update-accepted",
  "message": {
    "metadata": {
      "desired": {
        "color": {
          "timestamp": 1677062235
        }
      }
    },
    "state": {
      "desired": {
        "color": "green"
      }
    },
    "version": 1,
    "timestamp": 1677062235
  }
}

{
  "traceId": "61ff9ff8-1f8e-0dbf-7fb5-d90c5b7af5fe_mod1-update-delta",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T10:37:15.733+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/update/delta",
  "eventType": "mod1-update-delta",
  "message": {
    "metadata": {
      "color": {
        "timestamp": 1677062235
      }
    },
    "state": {
      "color": "green"
    },
    "version": 1,
    "timestamp": 1677062235
  }
}

{
  "traceId": "61ff9ff8-1f8e-0dbf-7fb5-d90c5b7af5fe_mod1-update-documents",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T10:37:15.733+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/update/documents",
  "eventType": "mod1-update-documents",
  "message": {
    "previous": null,
    "current": {
      "version": 1,
      "metadata": {
        "desired": {
          "color": {
            "timestamp": 1677062235
          }
        }
      },
      "state": {
        "desired": {
          "color": "green"
        }
      }
    },
    "timestamp": 1677062235
  }
}

{
            "traceId": "04e5e83e-b118-3294-84ed-140aaf000bb1_mod1-update-rejected",
            "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
            "receivedUtc": "2023-02-28T12:12:14.933+0000",
            "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/sha1/update/rejected",
        "eventType":"mod1-update-rejected",
            "message": {
                "message": "Payload contains invalid json",
                "code": 400
            }
}

{
  "traceId": "1fb37965-6242-d7b4-5ec1-f47b127542f9_mod1-get-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T10:51:50.416+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/get/accepted",
  "eventType": "mod1-get-accepted",
  "message": {
    "metadata": {
      "desired": {
        "color": {
          "timestamp": 1677062235
        }
      }
    },
    "state": {
      "desired": {
        "color": "green"
      },
      "delta": {
        "color": "green"
      }
    },
    "version": 1,
    "timestamp": 1677063110
  }
}

{
            "traceId": "29584894-9c23-bfe7-5ceb-eef1389f7224_mod1-get-rejected",
            "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
            "receivedUtc": "2023-02-28T12:04:08.404+0000",
            "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/get/rejected",
            "eventType":"mod1-get-rejected",
            "message": {
                "message": "No shadow exists with name: 'e0e0761f-001c-42a8-9851-07df3f11e080~mod1'",
                "code": 404
            }
}

{
  "traceId": "21389ed5-5dbb-f2e9-4d19-448c8842f5d3_mod1-delete-accepted",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22T10:53:15.026+0000",
  "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod1/delete/accepted",
  "eventType": "mod1-delete-accepted",
  "message": {
    "version": 1,
    "timestamp": 1677063195
  }
}

{
            "traceId": "878a8ebe-d58e-8e80-6aef-53b70241499f_mod1-delete-rejected",
            "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
            "receivedUtc": "2023-02-28T12:07:01.297+0000",
            "topic": "$aws/things/e0e0761f-001c-42a8-9851-07df3f11e080/shadow/name/mod11/delete/rejected",
         "eventType":"mod1-delete-rejected",
            "message": {
                "message": "No shadow exists with name: 'e0e0761f-001c-42a8-9851-07df3f11e080~mod1'",
                "code": 404
            }
}

{
            "traceId": "ba304805-ffe5-73d6-a2ad-b4d613ed5011",
            "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
            "receivedUtc": "2023-02-21T13:00:28.705+0000",
            "topic": "afe33340-2e50-4222-8c5e-4337ddb2f5e2/gps",
            "message": {
                "lat": 100,
                "long": 100
            }
}

{
    "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
    "epochTime": 1700133531774,
    "receivedUtc": "2023-11-16T11:18:51.774+0000",
    "topic": "385b3a28-353e-4043-a764-1571b1481a9e/gps/08",
    "traceId": "c5788a51-acde-c5ab-9737-7458b9927944",
    "message": {
        "raw_message": {

        "latitude": 12.963351073787331,
        "longitude": 80.24474137967132
        },
        "user_properties": [
        {
            "data1": "test1"
        },
        {
            "data2": "test2"
        }
        ],
        "system_properties": {
        "format_indicator": "UTF8_DATA",
        "content_type": "application/json",
        "correlation_data": "YmEwNWVkODQtNjg2ZS00OTRjLWI5MzMtODYyY2U1MzViMmIy",
        "response_topic":"385b3a28-353e-4043-a764-1571b1481a9e/gps/response",
        }
}
}

:::

{
  "traceId": "0bf9d452-d0ed-7018-c6b3-3af6a0f155db",
  "clientId": "e0e0761f-001c-42a8-9851-07df3f11e080",
  "receivedUtc": "2023-02-22 05:58:14.618",
  "eventType": "error",
  "topic": "iot/events/afe33340-2e50-4222-8c5e-4337ddb2f5e2/error",
  "message": {
    "reason": "AUTHORIZATION_FAILURE",
    "protocol": "MQTT",
    "logLevel": "ERROR",
    "errorEventType": "Publish-In",
    "topicName": "unknownTopic/test",
    "details": "Authorization Failure",
    "status": "Failure"
  }
}

{
"traceId": "bd3a0932-ard3-49f3-afa6-2228c40f7bb5",
"clientId": "3360570f-925d-3d4c-9e07-ec4373484a86",
"receivedUtc": "2023-11-17T10:50:59.422Z",
"eventType": "certificate-expiry",
"message": {
    "issuer": "CN=mtls.stage.id.trimble cloud.com-test",
    "subject": "CN=TestDevice",
    "registrationDateTime": "2023-11-17T10:24:34.179Z",
    "expirationDateTime": "2026-11-16T10:24:05.000Z"
}
}

This event cannot be retrieved using events API.

 {
"traceId": "b3b406eb-932d-414b-9f42-6fa082f06945",
"clientId": "f63b7a15-6997-4539-8762-6cde05b155bc",
"receivedUtc": "2025-11-26T14:07:45.274+0000",
"topic": "platform/devices/f63b7a15-6997-4539-8762-6cde05b155bc/events/license-notification",
"message": {
    "event_name": "license_assigned",
    "event_id": "b3b406eb-932d-414b-9f42-6fa082f06945",
    "time": "2025-11-26T14:07:43Z",
    "source": "ems",
    "data": "{\"entitlementId\": \"0976985b-3fe3-4f37-a126-963485af0ec7\", \"licenseId\": \"f4c3e2c9-505c-4afd-9186-e78fec1c93fd\", \"holderId\": \"f63b7a15-6997-4539-8762-6cde05b155bc\", \"sku\": {\"id\": \"TES-SB-T4D-123\", \"type\": \"product\"}}"
    }
}

{
"traceId": "a2ffb9bc-14aa-4dfc-a22b-359661f3dd3f",
"clientId": "f63b7a15-6997-4539-8762-6cde05b155bc",
"receivedUtc": "2025-11-26T14:08:34.278+0000",
"topic": "platform/devices/f63b7a15-6997-4539-8762-6cde05b155bc/events/license-notification",
"message": {
    "event_name": "license_revoked",
    "event_id": "a2ffb9bc-14aa-4dfc-a22b-359661f3dd3f",
    "time": "2025-11-26T14:08:32Z",
    "source": "ems",
    "data": "{\"entitlementId\": \"0976985b-3fe3-4f37-a126-963485af0ec7\", \"licenseId\": \"f4c3e2c9-505c-4afd-9186-e78fec1c93fd\", \"holderId\": \"f63b7a15-6997-4539-8762-6cde05b155bc\", \"sku\": {\"id\": \"TES-SB-T4D-123\", \"type\": \"product\"}}"
    }
}