GET
/
v1
/
entities
/
{entityId}
/
readings
Retrieves Readings
curl --request GET \
  --url https://prd.der-connect.eliagroup.eu/api/v1/entities/{entityId}/readings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "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"
    }
  ],
  "links": {
    "next": "<string>"
  },
  "meta": {
    "continuationToken": "<string>",
    "pageSize": 123
  }
}

Authorizations

Authorization
string
header
required

Access Token Authentication

Path Parameters

entityId
string<uuid>
required

The id of the Entity

Query Parameters

start
string<date-time>
required

The start of the time frame

end
string<date-time>

The end of the time frame

resample
string

When possible the Readings will be resampled to the provided resolution

pageSize
integer
default:25

The number of Readings per page

continuationToken
string

The token used to retrieve the next page

Response

200
application/json

OK

A page of readings.