Plan and usage
Plan and usage shows what your organization’s plan includes and how much of it you’ve used. Every role can open it. Sandbox sends with an sf_test_ key and inbound messages are never counted.
Read the page
Section titled “Read the page”-
Click Plan and usage in the sidebar under Settings.
Open Plan and usage. -
Current plan names your plan and lists any add-ons (extra phones or seats); the limits on the page already include them. Under it are two meters: Messages today and Messages this month, each with when it resets.
Your message allowance for the day and the month. -
Included in your plan counts what you have against what the plan allows: Phones, Seats, API keys and Webhook endpoints. Each meter links to the page where you manage it.
Phones, seats, API keys and webhook endpoints against their limits. -
Other limits lists the limits that aren’t counts, and Features lists every feature, ticked where your plan includes it.
Other limits and the features in your plan. -
Compare plans is the public price list, with your plan marked Your plan.
Compare your plan with the others.
What each limit means
Section titled “What each limit means”A meter shows the count, the limit, and the state in words: the share used, then a warning colour from 80%, then Limit reached. A limit shown as No fixed limit isn’t capped.
| Limit | What counts | At the limit |
|---|---|---|
| Messages today, Messages this month | One message for each recipient of an outbound send, from the composer, campaigns, one-time codes and the API. Blacklisted recipients aren’t counted. Days and months are UTC. | New sends are refused until the allowance resets. A running campaign pauses; resume it after the reset. |
| Phones | Paired phones. | You can’t pair another phone. |
| Seats | Members plus open invitations. | You can’t invite anyone else. |
| API keys, Webhook endpoints | Keys and endpoints that exist, revoked ones excepted. | You can’t create another. |
| API requests per minute, per key | Every request made with one API key. | The API answers 429 rate_limited until the minute passes. |
| Recipients per request | Numbers in one send. | The send is refused; split it, or use a campaign. |
| SIMs per phone | SIMs a phone registers. Shown only when the plan sets it. | Extra SIMs aren’t registered. |
| Message history, Audit log | How long messages and audit entries are kept. | Older ones are deleted. |
| “Sent with SMSFabric” line | Whether the plan adds that line to every message. | – |
At a limit nothing is removed: your phones, members, keys and endpoints keep working. You can’t add another until one is removed or the plan changes.
When a limit is reached
Section titled “When a limit is reached”The portal tells you before you click. These shots are from an organization on Free with its allowance and phone limit used up.
-
On Plan and usage, a used-up meter turns red, says Limit reached, and says when sending resumes.
A meter at its limit. -
A button for something your plan has no room for stays visible but dimmed. Point at it, or focus it with the keyboard, to read why.
A dimmed button says why. -
Clicking it shows the reason with See plan and usage, which opens this page.
The reason, with a link to Plan and usage. -
A feature outside your plan shows a note in place, with the same link. Here, the Pools panel on a plan without pools.
A feature outside your plan. -
On Send, the composer says when the allowance is used up and keeps the send button off until it resets. Send later is off on plans without scheduled sends.
The composer at the allowance.
If the API refuses something because of the plan (for example, when usage changed in another tab), the error in the dialog or form carries the same See plan and usage link.
In the API
Section titled “In the API”The same limits apply to API calls. A refusal is a problem response with a code and a params object you can word in your own language:
| Code | Status | Means |
|---|---|---|
plan_limit_reached |
403 |
A counted limit is reached: params.resource is phones, seats, apiKeys, webhooks or recipients. |
feature_not_in_plan |
403 |
The feature isn’t in the plan: pools, scheduled sends or CSV export. |
quota_exceeded |
429 |
The daily or monthly message allowance is used up. Retrying soon doesn’t help: wait for the reset. |
GET /v1/org/plan returns the plan, limits, usage and reset times, so an integration can check before it sends. See Errors.
Change your plan
Section titled “Change your plan”Billing isn’t live yet, so no plan is charged and there’s no upgrade button. To move to another plan, or to add phones or seats, write to support@smsfabric.com. The SMSFabric team makes the change and the page updates at once. When the team sets a limit just for your organization, Current plan says so.