---
title: "MeteredUsage"
description: "one row per metered call, written by the metering middleware in the same unit of work as the call; a call whose row cannot be written does not complete"
section: concepts
address: /concepts/meteredusage
contract: 0476e35e6e275db5
---

# MeteredUsage

one row per metered call, written by the metering middleware in the same unit of work as the call; a call whose row cannot be written does not complete

[figure: MeteredUsage is a fact at follows scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | fact |
| scope | follows |
| key | the call's key and the kind |
| store | postgres+lake |
| family | operations |



## Fields


| field | type | required | note |
|---|---|---|---|
| `kind` | [KindOfUsage](/concepts/kindofusage) | yes |  |
| `quantity` | `count` | yes | in the kind's unit |
| `cost` | [Cost](/concepts/cost) | yes | with its basis |
| `caller` | [Caller](/concepts/caller) | yes | read from the telemetry context, never from an argument |
| `scope` | [Scope](/concepts/scope) | yes | the tenant, brand or strategy |
| `grant` | `id` | no |  |
| `work_key` | `text` | yes | the job's, the move's or the turn's key |
| `trace_id` | `text` | yes |  |
| `provider` | `text` | no |  |
| `at` | `time` | yes |  |



## Routes that use it
No route takes or returns MeteredUsage directly. The record holds it, and the objects that point at it reach it.