Usage and billing

Usage and billing

The usage page lives at /admin/ui/orgs/<your-slug>/usage and answers two questions you’d otherwise have to ask your account team for: how many scans your org has consumed this month, and how that compares to your tier’s cap. It’s read-only and visible to anyone with the overview:r capability on the org (owners, admins, and viewers by default).

Open it from the org-detail page’s sidebar, or jump straight in from a deep link in a Slack message.

What the page shows

Three header cards land at the top:

• Tier — the current billing tier (free / team / org / enterprise). This is the same value the org-detail page’s tier ribbon surfaces; changes are written to your audit log as tier_changed:<from>-><to>.
• Scans this month — the count of verdict-producing scans the engine has recorded in the current calendar month, alongside the percentage of your soft cap that represents. The number is eventually-consistent — scan-volume writes are fire-and-forget, so a high-traffic minute may show slightly below real volume. The “last write” caption is the freshness signal.
• Period — the YYYY-MM label for the month the count covers, plus the timestamp of the most recent scan-volume write into the bucket.

If your tier has a soft cap (today: free), the page renders a progress bar below the cards with a colour band:

• OK (green) — under 70% of the soft cap. Comfortable headroom.
• Approach (amber) — between 70% and 99%. Plan for an upgrade conversation; the cap-approach email goes out separately when configured.
• Over (red) — at or above 100%. Hard-cap enforcement may apply depending on your contract; speak to your account team.

The org and enterprise tiers have no soft cap today — the page surfaces “Unlimited” copy in place of the progress bar.

12-month history

Below the cards, a sparkline + table render the last 12 calendar months of scan volume, oldest → newest. Months with no scans land as 0 so the X-axis stays continuous. The sparkline accent matches the same widget used on the audit page so the visual language is consistent.

Hand-offs

A link at the bottom of the page jumps to /admin/ui/orgs/<slug>/members for seat management. Seat purchases (“buy more seats”) and payment-provider integration aren’t on this page yet — those depend on infrastructure we haven’t yet committed to ship.

Related pages

• Members and teams — manage seat consumption (active / suspended / removed).
• Audit log — every tier_changed:<from>-><to> envelope appears in your tenant’s audit log and on the super-admin per-org billing page (Upwarden staff only).