# Usage & Quotas

Read model usage and understand quota enforcement boundaries.

## Usage summary

SeaRouter writes usage attribution with user, org, project, token, request, runtime session, provider, modality, model, and route context.

Use `GET /api/searouter/v1/usage/summary` with `usage:read`, `billing:usage:read`, `searouter:usage:read`, or an admin/service route scope.

```bash
curl https://seachat.ai/api/searouter/v1/usage/summary \
  -H "Authorization: Bearer $SEACHAT_API_KEY"
```

## Quota source of truth

User account quotas live in Seaplane. Model calls reserve and capture quota through the control plane; API key spend policy metadata is not the only enforcement layer.

