Get Advanced Temperature Statistics API
This API fetches and delivers a time series of hourly temperature data to the customer's business system. It can be used for the following use cases:
-
Field operations act on Advanced Temperature Monitoring recommendations, out of the business system (work order management system).
Get Bulk request and response examples
Used to request a large data file in the format of your choice (Parquet, Orc, Json, CSV) for downloading when the request can take several minutes to complete.
-
Data product ID. 5d796eb5-382e-47c4-b6f5-6684c2b6445b
-
Data latency. Three minutes or greater, depending on query parameters.
-
Maximum result size. Millions.
-
Data availability. Last 13 months.
Example request
POST /dpss/api/v1/subscriptions/{{subscriptionid}}/batch-request HTTP/1.1
Host: k8s.itrontotal.com
Authorization: Bearer
Itron-CorrelationId: {{UUID}}
DataSubscriberId: {{DataSubscriberId}}
Content-Type: application/json
Content-Length: 440
{
"filetype": "csv",
"Tokens": {
"StartMeasurementDate": "2024-07-01",
"EndMeasurementDate": "2024-07-02",
"StartReceivedDateTime": "",
"EndReceivedDateTime": "",
"Device": "",
"ElectronicSerialNumber": "",
"Meter": "",
"MeterNumber": "",
"ServicePoint": "",
"Premises": "",
"Transformer": "",
"Feeder": ""
},
"isOhsRequest": false
}Example response CSV
ReceivedTime,ServicePointID,MeterID,MeterNumber,ElectronicSerialNumber,TransformerId,PremiseId,FeederId,MeasurementTime,AvgTemp,MaxTemp
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T00:59:59:000Z,44,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T01:59:59:000Z,44,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T02:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T03:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T04:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T05:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T06:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T07:59:59:000Z,45,45
2025-12-14T00:30:34:000Z,MF0-01,J4246176,J4246176,2.16.840.1.114416.34.357478112,LABTXB,T50-DIDA,,2025-12-13T08:59:59:000Z,44,44Used to request a smaller data set 'on demand' with very low latency.
-
Data latency. Three minutes or greater, depending on query parameters.
-
Maximum result size. 1,000 rows.
-
Data availability. Last 13 months.
Example request
POST /dpss/api/v1/subscriptions/{{subscriptionid}}/on-demand HTTP/1.1
Host: k8s.itrontotal.com
Authorization: Bearer
Itron-CorrelationId: {{UUID}}
DataSubscriberId: {{DataSubscriberId}}
Content-Type: application/json
Content-Length: 370
{
"StartMeasurementDate": "2023-09-12",
"EndMeasurementDate": "2023-09-13",
"StartReceivedDateTime": "",
"EndReceivedDateTime": "",
"Device": "",
"ElectronicSerialNumber": "",
"Meter": "",
"MeterNumber": "",
"ServicePoint": "",
"Premises": "",
"Transformer": "3337439715-9082057X",
"Feeder": ""
}Example response
[
{
"RecievedTime": "2023-09-13T00:29:55.55Z",
"ServicePointId": 9000372474,
"MeterId": 1000634831,
"MeterNumber": 1000634831,
"ElectronicSerialNumber": "2.16.840.1.114416.15.80.1000634831",
"TransformerId": "4929542183-90777887",
"PremiseId": "P9000372474",
"MeasurementTime": :2023-09-12T01:00:00.000Z
"AvgTemp": 118,
"MaxTemp": 147.5,
},
{
"RecievedTime": "2023-09-13T00:29:55.55Z",
"ServicePointId": 9000372474,
"MeterId": 1000634831,
"MeterNumber": 1000634831,
"ElectronicSerialNumber": "2.16.840.1.114416.15.80.1000634831",
"TransformerId": "4929542183-90777887",
"PremiseId": "P9000372474",
"MeasurementTime": :2023-09-12T02:00:00.000Z
"AvgTemp": 119,
"MaxTemp": 137.5,
},
]Parameters
|
Name |
Description |
Operators |
Required |
Type |
Format |
Default |
Range |
Origination |
|---|---|---|---|---|---|---|---|---|
|
StartMeasurementDate |
Start date being queried as Min(MeasurementTime) |
Greater than or equal to |
No |
Date time |
YYYY-MM-DD |
2020-01-01T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
Edge app |
|
EndMeasurementDate |
End date being queried as Max(MeasurementTime) |
Less than or equal to |
No |
Date time |
YYYY-MM-DD |
9999-12-31T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
Edge app |
|
StartReceivedDatetime |
Min ReceivedTime data |
Greater than or equal to |
No |
Date time |
YYYY-MM-DDTHH:MM:SSZ |
2020-01-01T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
App Platform |
|
EndReceivedDatetime |
Max ReceivedTime data |
Less than or equal to |
No |
Date time |
YYYY-MM-DDTHH:MM:SSZ |
9999-12-31T00:00:00.0Z |
(Current UTC Date) to (Current UTC Date - 13 months) |
App Platform |
|
EntityType |
Service point, meter, ESN, transformer, premise, none |
eq |
No |
String |
N/A |
N/A |
N/A |
DIS |
Data values
|
Name |
Description |
Type |
Units |
Range |
Format |
Nullable |
Origination |
|---|---|---|---|---|---|---|---|
|
ReceivedTime |
When the data was received by the App Platform |
Date time |
N/A |
N/A |
YYYY-MM-DDTHH:MM:SSZ |
No |
App Platform |
|
ServicePointId |
Service Point ID as of EventDate |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
MeterId |
Meter ID as of EventDate |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
MeterNumber |
Meter Number as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
ElectronicSerialNumber |
Electronic Serial Number |
String |
N/A |
N/A |
N/A |
No |
CIS MDMS GIS |
|
TransformerId |
Transformer ID as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
PremiseId |
Premise ID as of EventDate |
String |
N/A |
N/A |
N/A |
Yes |
CIS MDMS GIS |
|
MeasurementTime |
UTC end time for which the temperature measurements have been collected |
Date time |
N/A |
N/A |
YYYY-MM-DDTHH:MM:SSZ |
No |
Edge app |
|
AvgTemp |
Average temperature over the interval period |
Real |
Celsius |
-256 to 255 |
N.NN |
No |
Edge app |
|
MaxTemp |
Maximum temperature over the interval period |
Real |
Celsius |
-256 to 255 |
N.NN |
No |
Edge app |
|
MeasurementTime |
Average temperature over hour two |
Real |
Celsius |
-256 to 255 |
N/A |
N/A |
DCA |