Skip to content
Shortcut: /, ⌘K or Ctrl+K

Number tiers

Compare the Free, Standard and Pro tiers, see how a Number's 24-hour billing windows work, and change a Number's tier.

View as Markdown

Each Number has a tier: Free, Standard or Pro. The tier sets the Number's capabilities and limits, and what it costs for each 24-hour window it is online. A project's default tier applies to its Numbers unless a Number has its own.

Compare tiers#

FreeStandardPro
Credits per 24-hour window02536
Throughput5 messages/s10 messages/s100 messages/s
Included data1 GB25 GB100 GB
Inbound calls per month5UnlimitedUnlimited
Outbound calls per month550Unlimited
Serverless invocations per month1,000250,0001,000,000
CampaignsNoNoYes
BanSafe Lite: Safe Mode and warm-up planNoYesYes
Ban CreditNoNoYes

Numbers with the +55 calling code use 85% of the listed rate. The discount follows the Number's country code, not the payment currency. Every Number on a tier uses the same rate, however many Numbers the team connects.

You can choose Free only for test numbers, and test numbers use no credits whatever their tier. A Free team's one real Number runs on Standard at 0 credits. Real Numbers on Pay-As-You-Go use Standard or Pro. An Enterprise agreement can set a negotiated Standard or Pro rate.

How billing windows work#

A paid window lasts 24 hours from a successful connection.

  1. Pairing reserves the first window's credits before the pairing code appears. For a new pairing, the reservation covers the full rate.
  2. When the connection succeeds, Polymorfa reads the Number's calling code, applies any regional discount, charges the window and releases the rest of the reservation.
  3. When the window ends, the next window is charged if the Number is still running.

Reconnecting within paid time does not buy another window. Stop prevents further windows but does not pause time already paid. A Number that cannot fund its next window is suspended, with its pairing kept.

The Numbers table and the Number's details show Paid time remaining, which counts down to the end of the paid window even while the Number is stopped or disconnected. Paid window expired and No paid window mean what they say.

Cloud API Numbers whose WhatsApp charges Meta bills to you directly do not buy windows.

Restart a stopped Number#

A stopped Number needs a funded start to reconnect. A start is refused when the team lacks credit, when credit is protected for higher-priority projects, or when payments are on hold. A refused start buys no window and enables nothing; the Number shows as disconnected. Check the billing notice, add credits or adjust budgets and priority, then start it again.

Overages #

Usage above a tier's allowance uses credits. It is never blocked.

UsageApplies toRate
WhatsApp data, including media and hosted message storageStandard, Pro10 credits per GB-month
Outbound callsStandard20 credits per call
Serverless invocationsStandard, Pro100 credits per million

Allowances belong to each Number; unused allowances are not pooled across a project. Free has no overage. See Usage for what each Number consumed.

Change a Number's tier#

Console

  1. Open the Number's settings and choose its tier.
  2. Select Review plan change and check the credit charge and timing.
  3. Confirm. The Console shows the result once it is applied.

Closing the preview without confirming changes nothing.

API

  1. Quote the change with POST /platform/sessions/{sessionId}/tier-quotes. A null tierOverride returns the Number to the project default. A quote changes nothing and lasts ten minutes, or until the Number or price changes.
  2. Confirm the quote's quoteId with PATCH /platform/sessions/{sessionId}.
  3. Read GET /platform/sessions/{sessionId}/tier-quotes/{quoteId} until the result is applied or rejected. queued does not grant the tier.
cURL
curl -X POST "https://api.polymorfa.com/platform/sessions/$SESSION_ID/tier-quotes" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tierOverride": "pro" }'

# After the customer accepts this exact quote:
curl -X PATCH "https://api.polymorfa.com/platform/sessions/$SESSION_ID" \
  -H "Authorization: Bearer $POLYMORFA_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "quoteId": "'"$QUOTE_ID"'" }'

curl "https://api.polymorfa.com/platform/sessions/$SESSION_ID/tier-quotes/$QUOTE_ID" \
  -H "Authorization: Bearer $POLYMORFA_KEY"
TypeScript
const quoted = await platform.sessions.quoteTierChange("<number-id>", {
  tierOverride: "pro",
});
const quote = quoted.data.data;
console.log(quote.quote.amountCents, quote.quote.effectiveAtMs);

// After the customer accepts this exact quote:
await platform.sessions.setTierOverride("<number-id>", { quoteId: quote.id });

const result = await platform.sessions.retrieveTierChange("<number-id>", quote.id);
console.log(result.data.data.status);

Show the quoted charge before you confirm it. amountCents is in credits and can have up to six decimal places. Both calls need sessions:manage.

  • Upgrade: buys a full new 24-hour window when applied. The rest of the old window is not refunded or carried over.
  • Downgrade: the paid tier stays until its window ends and the new tier applies from the next window.
  • Not enough credit: the Number keeps its current tier and window.

To change the default for a project's Numbers, edit Default Number tier in the project's settings. See Change project settings.

See also#