Skip to main content
GET
/
v1.0.0
/
users
/
{userId}
/
meters
/
{meterId}
Meter data for user
curl --request GET \
  --url https://api.energy-hub.io/v1.0.0/users/{userId}/meters/{meterId} \
  --header 'X-API-KEY: <api-key>'
{
  "isOnline": true,
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "userId": "896f9d5a-b618-48a2-98ae-957059bf1bc9",
  "staticData": {
    "lastUpdated": "2023-11-07T05:31:56Z",
    "vendor": "FRONIUS",
    "name": "My device",
    "model": "Sunny Device",
    "siteName": "My Home"
  },
  "lastUpdated": "2023-11-07T05:31:56Z",
  "powerState": {
    "lastUpdated": "2023-11-07T05:31:56Z",
    "power": 12,
    "meterValue": 289.99
  },
  "locationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
X-API-KEY
string
header
required

API key used for authorization and authentication.

Path Parameters

​
userId
string
required

User ID

​
meterId
string<uuid>
required

Meter ID

Response

Successful operation

Object of meter response.

​
isOnline
boolean
required

Indicates if the meter is reachable trough the vendor system.

Example:

true

​
id
string<uuid>
required

The ID of the meter.

​
userId
string
required

The ID of the user.

Example:

"896f9d5a-b618-48a2-98ae-957059bf1bc9"

​
staticData
object
required

Object of static data of a home energy device.

​
lastUpdated
string<date-time>

The timestamp of the last update of any variable of the meter.

​
powerState
object

Object of power state of a meter.

​
locationId
string<uuid>

The location ID of the meter.