Billing & Usage
Foir provides built-in billing with usage tracking, plan management, and self-service subscription workflows. View your current usage, manage your subscription, and upgrade when you need more capacity.
Overview
Each tenant has a subscription to a billing plan that determines resource limits and available features. Foir tracks usage in real-time and provides visual indicators when you approach or exceed plan limits.
Plans
Plans define what your team can do and how much capacity you have. Each plan includes:
| Property | Description |
|---|---|
| Name | Plan display name (e.g., “Pro”, “Enterprise”) |
| Price | Monthly or yearly price |
| Billing interval | Monthly or yearly |
| Features | List of included features |
| Limits | Resource quotas per billing metric |
Browse available plans on the Pricing page without logging in. Your current plan is highlighted, and available upgrades are shown with feature comparisons.
Usage Tracking
Foir tracks resource usage across your tenant in real-time:
| Metric | Description | Resets |
|---|---|---|
| Records | Total content and data records | Never (cumulative) |
| Models | Number of models | Never (cumulative) |
| API Requests | Public API calls | Monthly |
| Media Storage | Total file storage (bytes) | Never (cumulative) |
| Media Transformations | Image resize/format operations | Monthly |
| AI Embeddings | Vector embeddings generated | Monthly |
| Semantic Searches | Semantic search queries | Monthly |
| Operation Executions | Custom operation runs | Monthly |
| Users | Team members | Never (cumulative) |
| Projects | Number of projects | Never (cumulative) |
Usage Indicators
The billing dashboard shows visual progress bars with color-coded status:
| Status | Threshold | Color |
|---|---|---|
| OK | Below 80% | Green |
| Warning | 80-89% | Yellow |
| Approaching | 90-99% | Orange |
| Exceeded | 100%+ | Red |
When usage approaches or exceeds limits, warning banners appear across the admin dashboard with upgrade prompts.
In the Admin
Viewing Your Subscription
Navigate to Settings > Billing to see:
- Current plan name and status
- Billing period (start and end dates)
- Price and billing interval
- Usage summary with progress bars
- Recent invoices
Subscription Status
| Status | Description |
|---|---|
active | Subscription is current and paid |
trialing | In a free trial period |
past_due | Payment failed, grace period active |
canceled | Canceled but still active until period end |
incomplete | Initial payment pending |
Upgrading or Downgrading
- Go to Settings > Billing
- Click Change Plan or respond to an upgrade prompt
- Compare plans — your strained metrics are highlighted
- Select a new plan
- Add a payment method if upgrading to a paid plan
- Confirm the change
Upgrades take effect immediately. Downgrades take effect at the end of the current billing period.
Payment Methods
Manage payment methods under Settings > Billing > Payment Methods:
- Add a new credit or debit card via secure Stripe integration
- Set default payment method for automatic billing
- Remove saved payment methods
All payment processing is handled by Stripe. Foir never stores card numbers directly.
Invoices
View your billing history under Settings > Billing > Invoices:
- Filter by status (all, open, paid)
- View details — line items, amounts, tax, period covered
- Download PDF — generate PDF invoices for your records
- View on Stripe — link to the Stripe-hosted invoice page
Canceling
- Go to Settings > Billing
- Click Cancel Subscription
- Choose to cancel immediately or at the end of the billing period
- Your subscription remains active until the cancellation date
You can reactivate a canceled subscription before the period ends.
Limit Enforcement
Plans enforce resource limits in two ways:
| Mode | Behavior |
|---|---|
| Soft limit | Shows warnings but allows operations to continue |
| Hard limit | Blocks operations when limits are exceeded |
When a hard limit is exceeded, the relevant operation returns an error with a clear message indicating which limit was reached and a prompt to upgrade.
Cumulative metrics (records, models, storage, users, projects) are typically hard limits. Monthly metrics (API requests, transformations, embeddings) may use soft limits with overage warnings before enforcement.
Best Practices
- Monitor usage regularly — check the billing dashboard to stay ahead of limits before they affect your team.
- Upgrade proactively — do not wait for hard limits to block operations.
- Use monthly metrics wisely — API requests, AI operations, and transformations reset each billing period, so plan around your usage patterns.
- Keep payment methods current — avoid service interruptions from expired cards.
- Review invoices — verify charges match your expected usage.
- Use test mode keys for development — test mode API calls still count toward limits, but keeping environments separate helps with usage tracking.