Skip to content
View raw ↗

Usage Plans

Define the usage limits your billing plans 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 plans reference these, so "Pro includes 10,000 API calls" is enforced automatically.

SetExample
CapabilityAPI calls, storage, AI actions
Limit10,000 / month, 50 GB
Plan it belongs toFree, 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 page uses.

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

Show the code
ts
const usage = await foundation.account.usage()  // consumption vs configured limits

Reference