# Usage Plans

Define the usage limits your [billing plans](/platform/billing) enforce — how much of each capability a
plan includes, metered and capped for you.

## Configure

A usage plan maps a capability to a limit. Your [billing](/platform/billing) plans reference these, so
"Pro includes 10,000 API calls" is enforced automatically.

| Set | Example |
|---|---|
| **Capability** | API calls, storage, AI actions |
| **Limit** | 10,000 / month, 50 GB |
| **Plan it belongs to** | Free, Pro |

Foundation meters usage per user and enforces the limit — no metering code on your side.

## Use in your app

Read a user's usage and remaining allowance to show meters or gate features — the same data the
[Billing](/platform/billing#use-in-your-app) page uses.

**Tell your agent:** "Show the user's API usage this month as a progress bar."

```ts
const usage = await foundation.account.usage()  // consumption vs configured limits
```

## Reference

- [Billing & Plans](/platform/billing) — the plans these limits attach to
- [API Configuration](/platform/api-configuration) · [SDK reference](/api/sdk)