Skip to content

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.

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.

GET/v1/plans

The public price list: every public plan, in display order, in one page. No key is needed, and it answers during maintenance too.

Terminal window
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.

GET/v1/org/plan

Your 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.

Terminal window
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.