Reading imports

Base URL: $BUSINESS_API

Import a retry-safe batch of normalized utility readings

Logs

POST /reading-imports

Each source-file row is independently idempotent and follows the canonical Meter validation and review lifecycle.

Body application/json

batch_idstring · required
source_file_referencestring · required
rowsarray of object · required
Show child attributes
row_idstring · required
meter_idstring · required
valuestring · required
unitstring · required
measured_atstring (date-time) · required
evidence_idsarray of string · optional
estimate_reasonstring · optional

Returns

202 Per-row import outcomes

Permissions business:readings:import · Roles: admin, operations, owner

curl -X POST "$BUSINESS_API/reading-imports" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{
  "batch_id": "bat_2swXfESzjWaTZQE1poyvHAq9hCY",
  "source_file_reference": "SOU-2026-000142",
  "rows": [
    {
      "row_id": "row_2aIpfIwzRychTEcDNge7JkW5Ryw",
      "meter_id": "mtr_21F02THKOD7uMpvUalZKsBv64nN",
      "value": "value",
      "unit": "unit",
      "measured_at": "2026-11-19T09:30:00Z",
      "evidence_ids": [
        "evi_2N98GhhgsvHGkNNqQ3LICnXai7r"
      ],
      "estimate_reason": "estimate reason"
    }
  ]
}'
Response 202

Per-row import outcomes