# Usage Summary

> `GET /usage` · Account

Canonical page: https://clawifi.dev/docs/api/get-usage

`GET https://api.clawifi.dev/usage`

- Send your key as `Authorization: Bearer $CLAWIFI_API_KEY`; see [Authentication](https://clawifi.dev/docs/authentication).
- Credits: see [Pricing and credits](https://clawifi.dev/docs/pricing-and-credits).

## Request

**cURL**

```sh
curl https://api.clawifi.dev/usage \
  -H "Authorization: Bearer $CLAWIFI_API_KEY"
```

**Python**

```python
from clawifi import Clawifi

client = Clawifi()  # reads CLAWIFI_API_KEY
result = client.credits()
```

## Response

200 with a `UsageSummaryResponse` object: `aggregates`, `generated_at`, `total_events`, `total_units`.

Errors use the shared shape; see [Errors](https://clawifi.dev/docs/errors). Try public operations without a key in the [playground](https://clawifi.dev/playground).