API Reference
Core Resources
- Entities
- Collectives
- Tenants
Onboarding API
- Entity Onboarding
- Collective Onboarding
- Guided Onboarding
Readings API
- Readings
- Aggregations
Commands API
Charge Sessions API
Entity Settings
- Features
- Locations
- Battery Capacity
- Heated Area
- Disaggregators
- Custom Properties
Offboarding API
- Offboard Entities
Retrieve the last Reading for an Entity
Returns the most recent normalized Reading for an Entity
curl --request GET \
--url https://platform.realto.io/api/v1/entities/{entityId}/readings/last \
--header 'Authorization: Bearer <token>'{
"data": {
"instantaneousCurrent": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"instantaneousVoltage": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"isCharging": true,
"isPluggedIn": true,
"location": {
"address": "<string>",
"latitude": 123,
"longitude": 123
},
"locationMatches": [
{
"accuracy": 123,
"location": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>"
}
}
],
"negativeActiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"negativeActiveEnergyPhases": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"negativeActiveInstantaneousPower": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"negativeGasVolume": {
"unit": "<string>",
"value": 123
},
"odometer": {
"unit": "<string>",
"value": 123
},
"positiveActiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"positiveActiveEnergyPhases": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"positiveActiveInstantaneousPower": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"positiveGasVolume": {
"unit": "<string>",
"value": 123
},
"positiveReactiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"range": {
"unit": "<string>",
"value": 123
},
"stateOfCharge": {
"unit": "<string>",
"value": 123
}
},
"entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"measured": "2023-11-07T05:31:56Z",
"processed": "2023-11-07T05:31:56Z",
"received": "2023-11-07T05:31:56Z"
}Authorizations
Access Token Authentication
Path Parameters
The id of the Entity
Response
A reading.
The data of a reading.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A value indicating whether or not the entity is charging.
A value indicating whether or not the entity is plugged in.
The location of the reading matched to the entity locations.
A tiered measurement.
The total value.
The unit.
The value for tier one.
The value for tier two.
The value for tier three.
The value for tier four.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A tiered measurement.
The total value.
The unit.
The value for tier one.
The value for tier two.
The value for tier three.
The value for tier four.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A phased measurement.
The unit.
The value for phase one.
The value for phase two.
The value for phase three.
The total value.
A tiered measurement.
The total value.
The unit.
The value for tier one.
The value for tier two.
The value for tier three.
The value for tier four.
The id of the Entity
The id of the reading.
The timestamp of the reading.
The timestamp the reading was processed.
The timestamp the reading was received.
Was this page helpful?
curl --request GET \
--url https://platform.realto.io/api/v1/entities/{entityId}/readings/last \
--header 'Authorization: Bearer <token>'{
"data": {
"instantaneousCurrent": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"instantaneousVoltage": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"isCharging": true,
"isPluggedIn": true,
"location": {
"address": "<string>",
"latitude": 123,
"longitude": 123
},
"locationMatches": [
{
"accuracy": 123,
"location": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"label": "<string>"
}
}
],
"negativeActiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"negativeActiveEnergyPhases": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"negativeActiveInstantaneousPower": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"negativeGasVolume": {
"unit": "<string>",
"value": 123
},
"odometer": {
"unit": "<string>",
"value": 123
},
"positiveActiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"positiveActiveEnergyPhases": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"positiveActiveInstantaneousPower": {
"l1": 123,
"l2": 123,
"l3": 123,
"total": 123,
"unit": "<string>"
},
"positiveGasVolume": {
"unit": "<string>",
"value": 123
},
"positiveReactiveEnergy": {
"t1": 123,
"t2": 123,
"t3": 123,
"t4": 123,
"total": 123,
"unit": "<string>"
},
"range": {
"unit": "<string>",
"value": 123
},
"stateOfCharge": {
"unit": "<string>",
"value": 123
}
},
"entityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"measured": "2023-11-07T05:31:56Z",
"processed": "2023-11-07T05:31:56Z",
"received": "2023-11-07T05:31:56Z"
}