CRcreem
Meters

Preview an existing meter

Changed on

Dry-run an existing meter against your real usage over the last 7 whole UTC days (today included, future-dated events excluded). Same shape as the unsaved-definition preview; nothing is written.

post/v1/meters/{id}/preview

Request

Path parameters

idstring required

Response

Preview of the meter

matched_eventsnumber required

Events the meter would count over the preview window

unitsstring required

Aggregated units over the whole window, as a string for BigInt safety

distinct_customersnumber required

Distinct customers among the matching events

Example response

{
  "matched_events": 137,
  "units": "4820",
  "distinct_customers": 12,
  "daily": [
    {
      "date": "2026-08-16",
      "event_count": 42,
      "value": "1280"
    }
  ]
}

Changes