Plans
A plan sets what an organization may use: phones, seats, API keys, webhook endpoints, messages per day and per month, and features such as pools or scheduled sends. The portal shows your plan and usage under Settings (Plan and usage); until billing is live, the SMSFabric team makes plan changes. Where each limit is enforced, and the error it returns, is on Limits.
The plan object
Section titled “The plan object”| Field | Type | Description |
|---|---|---|
key |
string | Stable identifier, such as free, starter, pro, business or enterprise. |
name |
string | Display name, such as Starter. |
priceMonthlyCents |
integer or null | Monthly price in USD cents. null means priced by contract. |
priceAnnualCents |
integer or null | Annual price in USD cents. null means not offered, or priced by contract. |
priceIsStartingAt |
boolean | true when the monthly price is a starting price. |
limits |
object | The numeric limits below. |
addOns |
object | Extra phones and seats you can buy on this plan. |
features |
string[] | The features the plan includes. |
footerRequired |
boolean | Every outbound message ends with a Sent with SMSFabric line. |
support |
string | community, email_2d, email_1d, priority_4h or named_contact. |
isPublic |
boolean | Listed on the price list. |
sortOrder |
integer | Display order, lowest first. |
limits holds phones, simsPerPhone, seats, messagesPerMonth, messagesPerDay, apiKeys, webhooks, contacts and campaignRecipients (each a number, or null for no fixed limit), and apiKeyRequestsPerMinute, recipientsPerRequest, retentionDays and auditLogDays (always a number).
addOns holds extraPhonePriceCents and extraSeatPriceCents (null when the add-on is not sold on this plan), extraPhoneMessages (monthly messages each extra phone adds) and maxPhones (the most phones the plan reaches with add-ons, null for no cap).
features lists any of scheduled_sends, csv_export, templates, pools, campaigns, shared_inbox, analytics, verify_api, configurable_retention, cloud_routing, custom_roles, sso, siem_streaming, sla and data_residency.
List plans
Section titled “List plans”/v1/plansThe public price list: every public plan, in display order, in one page. No key is needed, and it answers during maintenance too.
curl https://api.smsfabric.com/v1/plans{ "data": [ { "key": "starter", "name": "Starter", "priceMonthlyCents": 900, "priceAnnualCents": 9000, "priceIsStartingAt": false, "limits": { "phones": 1, "simsPerPhone": null, "seats": 2, "messagesPerMonth": 5000, "messagesPerDay": 500, "apiKeys": 2, "webhooks": 2, "apiKeyRequestsPerMinute": 300, "recipientsPerRequest": 100, "retentionDays": 30, "auditLogDays": 30, "contacts": 1000, "campaignRecipients": 0 }, "addOns": { "extraPhonePriceCents": null, "extraPhoneMessages": 0, "maxPhones": null, "extraSeatPriceCents": null }, "features": ["scheduled_sends", "csv_export", "templates"], "footerRequired": false, "support": "email_2d", "isPublic": true, "sortOrder": 20 } ], "nextCursor": null}One plan is shown; data holds every public plan. The prices and limits change over time, so read them from this endpoint rather than copying them into your code.
Retrieve your plan
Section titled “Retrieve your plan”/v1/org/planYour organization’s plan, the limits that apply to it and what it has used. Any API key or signed-in user of the organization can call it; no scope is needed.
curl https://api.smsfabric.com/v1/org/plan \ -H "X-Api-Key: $SMSFABRIC_API_KEY"{ "plan": { "key": "pro", "name": "Pro" }, "limits": { "phones": 7, "simsPerPhone": null, "seats": 5, "messagesPerMonth": 35000, "messagesPerDay": 3500, "apiKeys": 10, "webhooks": 10, "apiKeyRequestsPerMinute": 1200, "recipientsPerRequest": 100, "retentionDays": 90, "auditLogDays": 365, "contacts": 10000, "campaignRecipients": 5000 }, "features": ["scheduled_sends", "csv_export", "templates", "pools", "campaigns", "shared_inbox", "analytics"], "footerRequired": false, "extraPhones": 2, "extraSeats": 0, "overridden": [], "usage": { "phones": 6, "seats": 4, "apiKeys": 3, "webhooks": 1, "messagesToday": 812, "messagesThisMonth": 20417 }, "dayResetsAt": "2026-11-20T00:00:00.000Z", "monthResetsAt": "2026-12-01T00:00:00.000Z"}| Field | Description |
|---|---|
plan |
The plan’s key and name. |
limits |
The plan’s limits with your add-ons applied: each extra phone adds one phone and extraPhoneMessages to the monthly allowance, and the daily allowance grows in the same proportion. A limit SMSFabric set for your organization replaces the plan’s. |
features |
The features you can use. |
footerRequired |
true when your messages get the Sent with SMSFabric line. |
extraPhones, extraSeats |
Add-ons on your organization. |
overridden |
Names of the limits SMSFabric set for your organization in place of the plan’s. |
usage |
What counts against the limits now. seats is members plus open invitations. messagesToday and messagesThisMonth count outbound messages, one per recipient; sandbox sends, blacklisted recipients and inbound messages are not counted. |
dayResetsAt, monthResetsAt |
When the daily allowance (00:00 UTC) and the monthly allowance (the 1st, 00:00 UTC) start again. |
When a send returns 429 quota_exceeded, these two times say when sending works again. See Errors.