> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# The tenant's consumption ledger rollup — documents processed and

> generated, delivery attempts — per kind, transaction set, and partner. The billing-grade counterpart to the Prometheus counters.

generated, delivery attempts — per kind, transaction set, and partner.
The billing-grade counterpart to the Prometheus counters.

### Query parameters

<ParamField query="from" type="string (date-time)">
  Period start (RFC 3339). Defaults to 30 days ago.
</ParamField>

<ParamField query="to" type="string (date-time)">
  Period end, exclusive (RFC 3339). Defaults to now.
</ParamField>

### Response

Returns `crate.usage.UsageSummary`.

<Note>
  The spec this page is generated from declares this response as an untyped object — the server
  returns JSON, but its shape is not published. Read a live response to see the fields; treat any
  field you find as unversioned until the spec names it.
</Note>

### Status codes

| Code  | Meaning                               |
| ----- | ------------------------------------- |
| `200` | Aggregated consumption for the period |
| `403` | Admin or tenant credential required   |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://edi.stateset.com/v1/usage' \
    --header 'Authorization: Bearer YOUR_API_KEY'
  ```
</RequestExample>