Skip to content
© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

EdgeEventController

EdgeEventController exposes REST endpoints for querying the inbound event log — downlink messages received from the server, like entity assignments, rule chain pushes, and RPC calls.

Base path: /api/edge/{edgeId}/events

Method Path Description
GET /api/edge/{edgeId}/events Returns a paginated list of edge events. Supports pageSize, page, textSearch, sortProperty, sortOrder, startTime, and endTime. Requires TENANT_ADMIN authority.

Edge maintains two separate event logs:

  • Cloud events at /api/edge/events: Outbound messages queued on Edge waiting to be sent upstream to the server, like telemetry, alarms, and entity changes. Accessible via EdgeController.
  • Edge events at /api/edge/{edgeId}/events: Downlink messages received from the server, like entity assignments, rule chain pushes, and RPC calls. Accessible via EdgeEventController.

Both queues use the same pagination interface and are useful for diagnosing synchronization issues. If the cloud events queue grows without draining, check the gRPC connection status via Edge status & events and message statistics.