---
title: "tool si.read.usage_statement"
description: "a period: the tenant's usage of the period by kind, priced, against the plan."
section: reference
address: /reference/tools/si-read-usage_statement
contract: 0476e35e6e275db5
---

# tool si.read.usage_statement

a period: the tenant's usage of the period by kind, priced, against the plan.

[figure: Over MCP, si.read.usage_statement takes UsageStatementInput and returns a card whose body is UsageStatement.]

the tenant's usage of the period by kind, priced, against the plan. The call needs the read grant at the tenant rung.



| | |
|---|---|
| input | [UsageStatementInput](/concepts/usagestatementinput) |
| result | a card whose body is [UsageStatement](/concepts/usagestatement) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/UsageStatement` |
| HTTP route | [`/v1/read/usage_statement`](/reference/read/usage_statement) |





| field | type | required | note |
|---|---|---|---|
| `period` | [Window](/concepts/window) | yes |  |