---
title: "tool si.view.usage"
description: "a tenant, a kind, a provider, a window: quantity and cost by kind, by tenant, by provider and by period, with each provider's reconciliation state."
section: reference
address: /reference/tools/si-view-usage
contract: 0476e35e6e275db5
---

# tool si.view.usage

a tenant, a kind, a provider, a window: quantity and cost by kind, by tenant, by provider and by period, with each provider's reconciliation state.

[figure: Over MCP, si.view.usage takes UsageInput and returns a card whose body is UsageReport.]

quantity and cost by kind, by tenant, by provider and by period, with each provider's reconciliation state. The call needs the read grant at the tenant rung.



| | |
|---|---|
| input | [UsageInput](/concepts/usageinput) |
| result | a card whose body is [UsageReport](/concepts/usagereport) |
| read-only | yes |
| destructive | no |
| card address | `ui://scale-intelligence/cards/UsageReport` |
| HTTP route | [`/v1/view/usage`](/reference/view/usage) |





| field | type | required | note |
|---|---|---|---|
| `tenant` | `id` | no |  |
| `kind` | [KindOfUsage](/concepts/kindofusage) | no |  |
| `provider` | `text` | no |  |
| `window` | [Window](/concepts/window) | yes |  |