Get a list of meters | Solvimon

curl https://test.api.solvimon.com/v1/meters \
     -H "X-API-KEY: <apiKey>" \
     -H "Content-Type: application/json"

{
  "data": [
    {
      "reference": "MTR-1001",
      "object_type": "meter",
      "id": "mtr_8f3b2c1a9d4e",
      "name": "Electricity Consumption Meter",
      "description": "Meter tracking electricity usage for building A",
      "status": "ACTIVE",
      "meter_values": [
        {
          "id": "mv_4a7d9e2b6c1f",
          "object": {
            "reference": "ELEC_KWH",
            "object_type": "meter_value",
            "id": "mv_4a7d9e2b6c1f",
            "name": "Kilowatt Hours",
            "description": "Energy consumption in kilowatt hours",
            "status": "ACTIVE",
            "type": "NUMBER"
          },
          "required": true
        }
      ],
      "meter_properties": [
        {
          "id": "mp_9c8e7f6d5b4a",
          "object": {
            "reference": "LOCATION",
            "status": "ACTIVE",
            "object_type": "meter_property",
            "id": "mp_9c8e7f6d5b4a",
            "name": "Location",
            "description": "Physical location of the meter",
            "type": "ENUM",
            "enum_values": [
              "Building A",
              "Building B",
              "Building C"
            ]
          },
          "required": true
        }
      ]
    }
  ]
}

Requires the METER.VIEW permission.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

versionstringRequiredDefaults to 1

version

Query parameters

statuses[]list of stringsOptional

Filter meters based on meter status(es)

expand[]list of stringsOptional

The id fields of the resources that are going to be expanded.

order_bystringOptional

The parameter by which the response is ordered.

order_directionstringOptional

The order direction by which the response is ordered.

Response

datalist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors