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.

The required scope is readings.

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.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

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

Example:

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

Authorize URL: https://app.enectiva.cz/en/api/dashboard

Token URL: /access_tokens

Path Params

Query Params

Header Params

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