Readings

Base URL: $CONSUMER_API

List readings for an explicitly linked account

Logs

GET /readings

Pages the meter readings of one linked account, each with its meter serial. account_id is required (400 without it) and the caller needs read access to the account, otherwise 403. Pagination uses limit and after.

Parameters

tenant_idstring · query · required

Tenant (utility workspace) that owns the account; when omitted it is worked out from the caller's account memberships.

account_idstring · query · required

Required identifier of the linked account whose readings are listed.

limitinteger · query · optional

Maximum resources to return (default 20, maximum 100).

afterstring · query · optional

Opaque cursor returned by the previous page.

meter_idstring · query · optional

Returns only readings of this meter.

statusstring · query · optional

Returns only readings in this status: submitted, validating, accepted, review_required, rejected or superseded; any other value returns 400.

one of submitted, validating, accepted, review_required, rejected, superseded

methodstring · query · optional

Returns only readings taken by this method: manual, consumer, remote, imported or estimated; any other value returns 400.

one of manual, consumer, remote, imported, estimated

Returns

200 Readings in the selected account after membership authorization

curl -X GET "$CONSUMER_API/readings" \
  -H "Authorization: Bearer sk_test_..."
Response 200

Readings in the selected account after membership authorization

Submit a meter reading for an explicitly linked account

Logs

POST /readings

Submits a self-read meter value for an active meter on a linked account where the caller has the reading create permission. meter_id, value, a unit that matches the meter's unit, measured_at, client_reading_id (up to 120 characters) and idempotency_key (up to 160 characters) are required, with up to 20 evidence ids. The reading is checked for plausibility and stays submitted (or review_required) for the utility to accept; reusing an idempotency key with different content returns 409, and the call answers 202.

Body application/json

tenant_idstring · required
account_idstring · required
meter_idstring · required
valuestring · required
unitstring · required
measured_atstring (date-time) · required
client_reading_idstring · required
idempotency_keystring · required
evidence_idsarray of string · optional

Returns

202 Consumer reading recorded for validation or review

curl -X POST "$CONSUMER_API/readings" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
  "meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
  "value": "value",
  "unit": "unit",
  "measured_at": "2026-11-19T09:30:00Z",
  "client_reading_id": "cli_20odFUijr6eh1g69pygb9smdNCU",
  "idempotency_key": "idempotency key",
  "evidence_ids": [
    "evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
  ]
}'
Response 202

Consumer reading recorded for validation or review