List readings of a meter - Enectiva REST API

This action allows to list readings of a single meter. Only valid and fully processed readings are included. Values are in the default unit of the corresponding energy. The values can be sorted, the default order is chronological.

The number of returned records is by default limited to 1000, see Limit & pagination for details. If more records satisfy your temporal filter, you can either keep the filter and paginate over the result set using the page parameter, or narrow down the filter with each request.

If you do not specify a unit, the readings will be returned in the unit configured in Enectiva. You can request readings in an alternative unit. The available units depend on the energy measured and match the units in the application. Supplying an invalid unit returns an error and lists the applicable units.

The required scope is readings.

Access via Access token, with the source accessibility determined by the permissions of the customer associated with the token and the Login token scopes used to obtain it

JWT Bearer

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/vnd.api+json

Body

Examples

With dataEmpty

{
  "data": [
    {
      "id": "5666368",
      "attributes": {
        "time": "2018-01-01T00:00:00.000Z",
        "state": 0,
        "unit": "kWh"
      },
      "type": "readings"
    },
    {
      "id": "5666365",
      "attributes": {
        "time": "2018-12-31T23:59:00.000Z",
        "state": 1200,
        "unit": "kWh"
      },
      "type": "readings"
    },
    {
      "id": "5657622",
      "attributes": {
        "time": "2019-09-30T12:46:00.000Z",
        "state": 10000,
        "unit": "kWh"
      },
      "type": "readings"
    }
  ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠406Not Acceptable

🟠409Conflict

🟠429Too Many Requests

🔴500Server Error