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

# Usage

> Read account-level usage totals.

`GET /v1/usage` returns account-level totals for reporting and reconciliation.
It can lag active sessions by a short delay, so don't rely on it for live
session control.

## Current month

```sh theme={null}
curl "https://api.protoface.com/v1/usage?period=current_month" \
  -H "Authorization: Bearer $PROTOFACE_API_KEY"
```

`period` can be `current_month` or `previous_month`.

## Custom range

```sh theme={null}
curl "https://api.protoface.com/v1/usage?period_start=2026-06-01T00:00:00Z&period_end=2026-07-01T00:00:00Z" \
  -H "Authorization: Bearer $PROTOFACE_API_KEY"
```

For a single running session, read the `usage` field on the session resource
instead.

## Next

<Columns cols={2}>
  <Card title="Quotas" href="/reference/quotas" icon="gauge">
    Session caps, usage rounding, and credit behavior.
  </Card>

  <Card title="Errors" href="/reference/errors" icon="triangle-alert">
    Handle retryable and quota responses.
  </Card>
</Columns>