List meters

GET

https://api.enectiva.cz//meters

Last modified:2025-09-03 14:39:20

This action allows to list meters of a specific customer. Only active meters are returned by default and deactivated meters can be included using the proper query parameter (include_deactivated). Virtual meters are not included.

This endpoint is paginated, see Limit & pagination for details. By default, at most 1000 records are returned.

The required scope is meters.

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

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.enectiva.cz//meters?include_deactivated' \
--header 'Accept: application/vnd.api+json' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/vnd.api+json

Body

Examples

With dataEmpty

{
    "data": [
        {
            "id":"293",
            "attributes":{
                "name":"Main electricity meter",
                "energy_code":"el",
                "energy_name":"electricity",
                "unit":"kWh",
                "status":"active",
                "last_measured_at":"2023-12-06T23:04:00.000Z",
                "entity_id":12345,
                "import_id":"40AABB_007"
            },
            "type":"meters"
        },
        {
            "id":"294",
            "attributes":{
                "name":"Main water meter",
                "external_id":"WA001",
                "energy_code":"wa",
                "energy_name":"water",
                "unit":"m³",
                "status":"active",
                "entity_id":12345
            },
            "type":"meters"
        },
        {
            "id":"295",
            "attributes": {
                "name": "Secondary water meter",
                "energy_code": "wa",
                "energy_name": "water",
                "status": "deactivated",
                "deactivated_at": "2021-12-31T23:00:00.000Z",
                "unit": "m³",
                "entity_id":12345
            },
            "type": "meters"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

🟠406Not Acceptable

🟠429Too Many Requests

🔴500Server Error

Modified at 2025-09-03 14:39:20

List readings of a meter

Meter