Retrieves the single most recent summarized reading for an ESA data point, across all of its channels
Use this to determine whether a data point has any summarized interval data, and how recent it is —
for example to decide between rendering a chart and rendering an empty state. Prefer it over
GET /api/v202410/esaReading/summarized with a single filter and a page size of one: that endpoint
is fully filterable and orderable, so it joins sixteen tables to build a wide response, which is
substantially more expensive when a caller only needs the latest value.
Returns readings from any channel on the data point; where several channels have data, the most recent
wins. Access is limited to data points beneath the authenticated user’s topmost node.
Request Headers
| Header | Value | Required | Description |
|---|---|---|---|
| ECI-ApiKey | string | Yes | Your API key. See Authentication. |
| Content-Type | application/json | Yes | All requests must specify JSON content type. |
Path Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| dataPointId | The ESA data point (meter) identifier to read. Must belong to the authenticated user’s owner and sit beneath their topmost node. | integer (int32) | Required |
Responses
200
OK
The request succeeded and the response body contains the requested data.
Response Body Parameters
EsaReadingLatestSummarizedResponse
| Property | Description | Type |
|---|---|---|
| esaChannelId | The channel the reading belongs to. A data point may have several channels; this is the one holding the most recent reading. | integer (int32) |
| localTimestamp | The reading’s local date and time at the data point’s time zone. | string (date-time) |
| summarizedValue | The summarized reading value, in the channel version’s unit at the time it was written. A unit change reprocesses and recalculates system-created readings — UnitId is one of the FieldsTriggeringProcessing in EsaChannelPostProcessJob — so those are always in the current unit. Manually-created readings are deliberately preserved by that job, which filters on creationSource = System, and can therefore retain an earlier unit. | number (double) |
| timestamp | The reading’s timestamp, with offset. | string (date-time) |
Example Response
{ "esaChannelId": 1, "localTimestamp": "2026-09-16", "summarizedValue": 1.0, "timestamp": "2026-09-16"
}
403
Forbidden
You do not have permission to access this resource. Check your user role and permissions.