List meters

GET

https://api.enectiva.cz/meters

Last modified:2026-06-30 18:50:36

This action allows to list meters of a specific customer. Only active meters are returned by default. To query only for deactivated meters include parameter deactivated=true. 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

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Responses

🟢200OK

application/vnd.api+json

Bodyapplication/vnd.api+json

Examples

With dataEmpty

{
    "data": [
        {
            "id":"293",
            "attributes":{
                "identification_code": "1234",
                "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",
                "measurement_type": "profile",
                "data_source": "manual",
                "address": "Viktora Huga 6"
            },
            "type":"meters"
        },
        {
            "id":"294",
            "attributes":{
                "identification_code": "9876",
                "name":"Main water meter",
                "external_id":"WA001",
                "energy_code":"wa",
                "energy_name":"water",
                "unit":"m³",
                "status":"active",
                "entity_id":12345,
                "measurement_type": "reading",
                "data_source": "manual",
                "address": null
            },
            "type":"meters"
        },
        {
            "id":"295",
            "attributes": {
                "identification_code": null,
                "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,
                "measurement_type": "reading",
                "data_source": "imported",
                "address": null
            },
            "type": "meters"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

🟠406Not Acceptable

🟠429Too Many Requests

🔴500Server Error

Modified at 2026-06-30 18:50:36

List entities

Meter