> ## 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

`object`

<ResponseField name="success" type="boolean" required />

<ResponseField name="data" type="crate.usage.UsageSummary" required />

<ResponseField name="period" type="object" required>
  The resolved reporting window.

  <Expandable title="period">
    <ResponseField name="from" type="string (date-time)" required />

    <ResponseField name="to" type="string (date-time)" required />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning                                                                                           |
| ----- | ------------------------------------------------------------------------------------------------- |
| `200` | Aggregated consumption for the period (defaults to the last 30 days when `from`/`to` are omitted) |
| `403` | Admin or tenant credential required                                                               |

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": null,
    "period": {
      "from": "2026-08-31T14:22:05Z",
      "to": "2026-08-31T14:22:05Z"
    }
  }
  ```
</ResponseExample>