---
sidebar_position: 1
title: Billing, Credits & Quotas
description: Manage workspace subscription tiers, agent seats, prepaid telecom & AI usage credits, invoices, and real-time concurrency quotas.
---

# Billing, Credits & Quotas

Firetell uses a transparent two-part billing architecture designed for cloud contact centers and Voice AI workloads:
1. **Workspace Subscription & Agent Seats** (`monthly` or `yearly` billing cycle) — unlocks platform features, concurrent call capacity, storage retention, and human agent seats.
2. **Prepaid Credit Wallet (`USD`)** — pay-as-you-go balance for metered telecom & AI consumption (PSTN call minutes, DID number setup/monthly fees, SMS/MMS segments, AI call transcriptions, and realtime Voice AI model minutes).

---

## Subscriptions & Credit Balance

Navigate to **Console → Settings → Billing** to manage plans, top up credits, and reconcile accounting records across three dedicated tabs.

### 1. Subscription & Credit (`Settings → Billing → Subscription & Credit`)

#### Workspace Subscription Lifecycle
- **Billing Cycles & Add-on Seats**: Choose between **Monthly** and **Yearly** billing cycles. Plans include a base allocation of agent seats, and you can scale additional human contact center seats on demand as your team grows.
- **Subscription Statuses**:
  - **`Active`**: All plan quotas, concurrent channels, and retention policies are active.
  - **`Canceling`**: Scheduled to terminate at the end of the current billing cycle; full workspace functionality remains active until the end of the paid period.
  - **`Past Due` / `Unpaid`**: Automatic renewal payment failed on your payment method. Update your card promptly to prevent plan downgrade or call routing suspension.
  - **`Canceled`**: Subscription has ended; workspace falls back to default tier limits.

#### Prepaid Credit Wallet
Your workspace maintains a real-time **Credit Balance** (`USD`) that funds metered telecom and AI activity:

| Metered Usage Type | When Credits Are Deducted | Ledger Attribution |
| :--- | :--- | :--- |
| **DID Number Provisioning** | Immediately upon purchasing a virtual phone number (one-time setup fee + first month's rental fee), then monthly on renewal. | DID purchase & monthly renewal |
| **Inbound & Outbound PSTN Calls** | Upon call completion based on connected billable duration and destination country prefix rate. | Linked to Call ID (`call_...`) |
| **Autonomous Voice AI Minutes** | Per connected minute at the selected realtime model's published `$rate/min` (shown directly in the Voice Agent model picker). | Linked to Call ID (`call_...`) |
| **AI Call Transcription & Summaries** | When post-call speech-to-text, speaker diarization, sentiment, and summary generation complete. | Linked to Call ID (`call_...`) |
| **SMS & MMS Messaging** | Per outbound/inbound carrier message segment. | Message delivery ledger entry |

:::tip[Real-Time Balance Webhooks]
Want to trigger internal Slack or PagerDuty alerts if your credit wallet runs low during a high-volume campaign? Subscribe to the `workspace.credit.updated` event under **Console → Settings → Webhooks**.
:::

---

### 2. Invoices & History (`Settings → Billing → Invoices & History`)

Every subscription renewal, seat adjustment, and prepaid credit top-up generates an official invoice record:
- View invoice status (`Paid`, `Open`, `Void`, `Refunded`), billing period dates, and payment amounts.
- Download itemized **PDF Invoices & Tax Receipts** directly for corporate accounting and expense reconciliation.

---

### 3. Credit Transactions (`Settings → Billing → Credit Transactions`)

The **Credit Transactions** ledger provides an immutable, searchable audit trail of every balance movement in your workspace:

| Transaction Type | Effect on Balance | Description |
| :--- | :---: | :--- |
| **`Deposit`** | `+` Credit | Self-service credit top-ups completed via online card checkout. |
| **`Promo`** | `+` Credit | Promotional onboarding or plan upgrade bonus credits. |
| **`Charge`** | `−` Debit | Automated per-call, Voice AI, transcription, SMS, or DID purchase/renewal deductions (click the linked Call ID to cross-reference the exact CDR). |
| **`Refund`** | `+` Credit | Reversed charges or refunded DID orders. |
| **`Adjustment`** | `+` / `−` | Manual billing reconciliation applied by Firetell Billing Support. |

---

## Workspace Limits & Quotas

Open **Console → Settings → Limits & Quotas** to inspect real-time resource consumption against your active plan's entitlements.

### Complete Entitlement & Quota Reference

| Quota Metric | Console Section | What It Controls |
| :--- | :--- | :--- |
| **Concurrent Calls** | `Settings → Limits & Quotas` | Maximum simultaneous active calls (inbound + outbound + Voice AI) across the workspace at any second. |
| **Monthly Included Call Minutes** | `Settings → Billing` | Monthly platform minute allowance before standard per-minute metering applies. |
| **Voice AI Agents** | `Voice Agents` | Maximum autonomous Voice AI assistants configured in the workspace. |
| **Knowledge Bases** | `Knowledge Bases` | Maximum RAG knowledge repositories (up to 100 documents per Knowledge Base). |
| **Workspace Storage** | `Settings → Limits & Quotas` | Combined storage pool for call recordings, uploaded IVR audio files, and Knowledge Base documents. |
| **Call Center Agents & Teams** | `Call Center → Agents / Teams` | Maximum human agent accounts (base seats + add-on seats) and department ring queues. |
| **Extensions & SIP Accounts** | `Call Center → Extensions / SIP Accounts` | Maximum internal dial extensions (`101`, `102`, …) and hardware IP phone / softphone registrations. |
| **Phone Numbers (DIDs)** | `Phone Numbers` | Maximum active virtual DIDs and connected BYOC SIP trunk numbers. |
| **Call Flows & Audio Prompts** | `Call Flows` / `Audio Files` | Maximum visual IVR routing graphs and studio prompt files. |
| **SIP Trunk ACLs & Gateways** | `SIP Trunks` | Maximum custom Inbound IP ACLs and Outbound Carrier Gateways (system-managed Firetell DID routes do not consume your custom quota). |
| **Workspace API Keys** | `Settings → API Keys` | Maximum active REST API keys for server-to-server integrations. |
| **Call Recording & Retention** | `Call Center → Recordings` | Controls external & internal call recording authorization and automatic retention period (days). |
| **Audit Log Retention** | `Settings → Audit Logs` | Number of days administrative & security events are retained for compliance review. |

### What Happens When a Limit Is Reached?

- **Configuration Limits** (such as Agents, Extensions, Voice AI Agents, or Knowledge Bases): The Console displays a clear quota banner when attempting to create a new resource. Delete unused drafts/resources or click **Change Plan** to upgrade your tier immediately.
- **Live Calling Concurrency**: If all concurrent call slots are occupied during a traffic spike, additional inbound or outbound call attempts receive SIP `503 Service Unavailable` until an active call disconnects or you upgrade your plan's concurrency tier.
