latestOpenAPI 3.0.02026-08-2217901.1 MB

ef9153fcac7c

Meter Readings

Batch create new meter readings

We strongly recommend using this endpoint to create meter readings since it is more efficient. <h3>Rate Limits</h3> <li>For Automated and IoT meter readings: 100 requests / 60 seconds</li> <li>For Manual meter readings: 10 requests / 24 hours</li>

post/meterreadings

Query parameters

skipWebhookboolean

Set skipWebhook=true, skipWebhook=1 or skipWebhook=yes to skip all webhooks upon successful operation on the endpoint. Learn more about webhooks

Request body

meterIdnumber required

Global ID of the meter.

valuenumber required

The reading value given by the meter.

readingDatestring nullable

Date at which the meter was read. This date can be set in the past, but cannot be further than 3 days for IoT meters.

Example request

[
  {
    "meterId": 53,
    "value": 120,
    "readingDate": "2022-01-01T00:00:00.000Z"
  }
]

Response

Successfully created meter readings

meterIdnumber required

Global ID of the meter.

valuenumber required

The reading value given by the meter.

createdAtstring required

Meter Reading creation/processing date.

readingDatestring nullable

Date at which the meter was read. This date can be set in the past, but cannot be further than 3 days for IoT meters.

Example response

[
  {
    "meterId": 53,
    "value": 120,
    "createdAt": "2022-01-01T00:00:00.000Z",
    "readingDate": "2022-01-01T00:00:00.000Z"
  }
]