---
title: "UsageStatement"
description: "a tenant's metered usage of a period by kind, priced, against the plan's included quantities"
section: concepts
address: /concepts/usagestatement
contract: 0476e35e6e275db5
---

# UsageStatement

a tenant's metered usage of a period by kind, priced, against the plan's included quantities

[figure: UsageStatement is a view at none scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | view |
| scope | none |
| key | none |
| store | derived |
| family | operations |



## Fields


| field | type | required | note |
|---|---|---|---|
| `period` | [Window](/concepts/window) | yes |  |
| `lines` | `[json]` | yes | kind, quantity, included, over, price, amount |
| `total` | `money` | yes |  |
| `plan_kind` | `one of trial \| paid \| internal` | yes |  |



## Routes that use it
- [`/v1/read/usage_statement`](/reference/read/usage_statement) returns it