Skip to main content
GET
Get consumption per supply

Authorizations

Authorization
string
header
required

Opaque mvy_test_ API key sent as a Bearer token. It derives exactly one workspace server-side; the path never carries a workspace selector.

Query Parameters

from
string<date-time>

Inclusive ISO-8601 start of the window (defaults to 30 days before to).

to
string<date-time>

Exclusive ISO-8601 end of the window (defaults to now).

granularity
enum<string>

Bucket size; defaults to day.

Available options:
day,
week
catalogItemId
string

Narrows the trend to one catalog item.

Response

The consumption trend.

metric
string
required
definition
string
required

The human-readable definition of the metric.

granularity
enum<string>
required
Available options:
day,
week
period
object
required
movementCount
integer
required

Every consumption movement read, measured or not.

timezone
string
required
asOf
string<date-time>
required
freshness
enum<string>
required
Available options:
live
evidenceId
string
required
truncated
boolean
required

True when the ledger scan hit its cap; it reads newest first, so coverage.coveredFrom says where the figures start.

filters
object
required
coverage
object
required
series
object[]
required
unverifiedItems
object[]
required
narration
object

The claims a summary may state, each equal to the evidence in its own unit. Included only when it passes the deterministic numeric-faithfulness check.