How account plans work
What your account plan sets for the whole account, which plan applies, and what happens when you reach a limit or move to a smaller plan.
In the dashboard
Your account plan sets what your whole account can have: how many websites and load balancers it holds, how many people share it, and the email, sending and storage it gets at no charge. Each account has one plan: Free, Pro, Business or Enterprise. Servers, instances, apps, extra storage and IP addresses are services of their own. You order them on any plan, and each is billed on its own.
Plans open in stages
Section titled Plans open in stagesCoritan opens account plans to accounts in stages. Until they open on yours:
GET /account/plananswers"enabled": false, andGET /account/entitlementsanswers"enforced": false.- The limits on this page do not refuse anything.
- Ordering, changing or trying a plan answers
403with{"code": "plans_not_open", "message": "Plans are not open on this account yet."}. - The dashboard keeps its earlier layout: Billing in the sidebar with no Plan tab, and the overview in place of Home (The dashboard).
You can cancel a plan and set up the services a plan includes at every stage.
The plans
Section titled The plans- Free
- Every account starts on Free. It costs nothing, needs no payment method and has no end date (The Free plan).
- Pro and Business
- Paid plans with higher limits, billed monthly or yearly. You can try either one free once, and order one or move between them.
GET /account/planlists each plan's current prices underavailable. - Enterprise
- Sold by our sales team, with the terms in your agreement. It cannot be ordered online: send an enquiry from the contact page or write to sales@coritan.com.
Which plan applies
Section titled Which plan appliesA paid plan that is active decides your limits. Without one, your free trial decides them while it runs. Without either, the account is on Free.
A plan you cancel keeps applying until the end of the period you paid for. While a paid plan is suspended for an unpaid invoice, the account has the Free plan's limits, and paying the invoice restores the plan (Failed payments and suspended services).
What each plan includes
Section titled What each plan includes| Free | Pro | Business | Enterprise | |
|---|---|---|---|---|
| Websites | 3 | 10 | 50 | Unlimited |
| Load balancers | 1 | 5 | 25 | Unlimited |
| Team members, you included | 1 | 3 | Unlimited | Unlimited |
| Activity log | No | No | Yes | Yes |
| Custom firewall rules | None | 20 | 100 | 1,000 |
| Rate limiting rules | None | None | 10 | 100 |
| Country rules | No | No | Yes | Yes |
| Cache settings | No | Yes | Yes | Yes |
| Your own certificates | No | Yes | Yes | Yes |
| Wildcard certificates | No | Yes | Yes | Yes |
| Query history | Last 24 hours | 30 days | 30 days | 30 days |
| Automatic backups for servers | No | Yes | Yes | Yes |
| Instances whose automatic backups the plan pays for | None | None | 3 | Every instance |
| Extra snapshot storage | None | 100 GB | 500 GB | Set in your agreement |
| Floating IPs the plan pays for | None | 1 | 2 | 10 |
| Shield Custom Profiles the plan pays for | None | None | 1 | 5 |
| Sharing a mailbox in webmail | No | No | Yes | Yes |
| Included Mail Hosting | 5 mailboxes of 1 GB on 1 domain | 10 mailboxes of 10 GB on 3 domains | 50 mailboxes of 25 GB on 10 domains | Mailboxes of 50 GB, with the number of mailboxes and domains set in your agreement |
| Included SMTP Relay | 3,000 emails a month | 25,000 emails a month | 100,000 emails a month | Set in your agreement |
| Included Object Storage | 10 GB | 250 GB | 1 TB | Set in your agreement |
| Support priority | Low | Medium | High | High |
| Target for our first support reply | 2 days | 1 day | 1 hour | 30 minutes |
- Websites
- Each DNS zone on your account is a website, and so is each web proxy whose hostname is not under one of your zones. The
example.comzone and a web proxy forwww.example.comcount as one website. A coritan.gg name is a DNS zone too. Coritan checks the limit when you add a domain you already own, claim a coritan.gg name or create a web proxy. - Load balancers
- The DNS load balancers across all your zones. Coritan checks the limit when you create a load balancer.
- Team members
- The people who can sign in to your account, you included. Coritan checks the limit when you invite someone.
- Activity log
- What you and your team members changed in your account, and who changed it, on the Activity tab of Settings (Review your account's activity).
- Custom firewall rules, rate limiting rules and country rules
- The rules of your own that are switched on in the WAF, counted across all your websites. Each rate limiting rule also counts as one of your custom firewall rules. A country rule is a rule that matches a visitor's country (Protect a website with the WAF).
- Cache settings, your own certificates and wildcard certificates
- Changing how the edge caches a website's pages (Cache pages at the edge), uploading a certificate of your own (Upload your own certificate) and ordering a wildcard (Issue a certificate with Coritan DNS).
- Query history
- How far back the DNS query counts on a website's Overview tab go. Free shows the last 24 hours (View DNS query statistics).
- Automatic backups
- On Pro and up, a server takes automatic backups without an add-on (Automatic backups). Business pays for the automatic backups add-on on up to three instances, and Enterprise on every instance (Automatic backups).
- Extra snapshot storage
- Room for server snapshots, added to what your servers and snapshot storage services include (How snapshot storage works).
- Floating IPs and Shield Custom Profiles the plan pays for
- Single IPv4 floating IPs and Shield Custom Profiles that cost $0 while the plan applies. You order them as usual, on their own or as add-ons to another order, and each one the plan has room for costs $0. A subnet, an IPv6 address and a larger custom profile bill at their own price on every plan. The plan pays for the oldest first (Cancel a floating IP, Order and use a custom profile).
- Sharing a mailbox
- Inviting another Coritan account to a mailbox on Coritan's own mail. Invitations you sent earlier keep working on any plan (Share a mailbox).
- Included Mail Hosting, SMTP Relay and Object Storage
- One service of each at no charge, which you set up once and which follows your plan (Set up the services your plan includes). On Enterprise, your agreement sets their size. The included Mail Hosting holds up to 1,000 mailboxes on 100 domains.
- Support priority and first reply target
- A support conversation you open starts at the plan's priority at least, even when you choose a lower one. We aim to send the first reply within the plan's target. Both come from the plan the account has when the conversation opens, and they stay with it after that (Start a conversation).
Our sales team can set other figures for an Enterprise account in its agreement.
When you reach a limit
Section titled When you reach a limitWhat you already have keeps working. Coritan refuses only what would take the account past a limit, such as a fourth website on the Free plan. The refusal says what the limit is, how much of it the account uses, and what raises it: a larger plan, or an add-on where one exists. In the dashboard, it opens a dialog with those offers (When your plan refuses something).
Over the API, the refusal is 402 with entitlement_exceeded:
{
"detail": {
"code": "entitlement_exceeded",
"entitlement": "websites_max",
"limit": 3,
"used": 3,
"upgrade": {"plan": "plan-pro", "addon": "addon-websites-pack"},
"message": "Your Free plan includes 3 websites, and this account has 3. To add more, upgrade to Pro or buy an add-on."
}
}
upgrade.plan is the smallest plan that allows one more, and upgrade.addon is the catalogue slug of the add-on that raises the limit. Either is null when there is none. When only our sales team can raise the limit, the message ends with Contact sales to raise it.
Moving to a smaller plan
Section titled Moving to a smaller planYour account moves to a smaller plan when you change down, when a plan you cancelled ends, and when a trial ends. Coritan deletes nothing when the plan changes:
- Everything above the new limits keeps working. You cannot add more of it until the account is back within the limit, or on a larger plan.
- Your included services move to the new plan's size. A Mail Hosting or SMTP Relay service that already uses more than that stays at what it uses, and Coritan lowers it each day as you remove things.
- Object Storage keeps every file. Storage above the new allowance counts as it does on any Object Storage service (When your buckets hold more than the allowance).
- Your snapshot allowance shrinks by the storage the new plan no longer adds. When your snapshots then take more than the allowance, a cleanup date is set, and Coritan deletes the oldest snapshots from that date unless the account fits again (When the account is over).
- The plan keeps paying for your oldest floating IPs and custom profiles, up to what the new plan pays for. The newest beyond that keep working, and each one renews at its own price from its next renewal (When your account plan pays for it).
The same happens while a paid plan is suspended for an unpaid invoice, because the account then has the Free plan's limits.
Before you confirm a smaller plan, its dialog on the Plan tab lists what the plan would leave above its limits, under a title such as Over the Free plan's limits. It lists the floating IPs and custom profiles that would renew at their own price under a title such as What the Free plan pays for (Choose or change your account plan). Over the API, POST /account/plan/preview lists the first in over_limit and the second in renew_at_own_price, each as {entitlement, limit, used} (Preview a plan).
The Plan tab
Section titled The Plan tabOnce plans open on your account, select Plan and billing in the sidebar of the dashboard, then the Plan tab. From the top, it shows:
- Your plan
- The plan's name and a line on what it costs and when that changes, such as
Renews on Oct 12, 2026 at $12/mo.A Free trial badge marks a trial, and a Cancelling badge a plan you cancelled. Its buttons start or end your trial, and cancel or keep a paid plan (Start a free trial, Choose or change your account plan). - What your account uses
- A meter for each count your plan limits, against its limit: Websites, Load balancers, Mailboxes, Mail domains, Emails sent this month and Object Storage. A count above its limit reads
Over your plan's limit. Until you set up an included service, its counts read a line such asCounted once you set up the email your plan includes.(Set up the services your plan includes). - Plans
- Free, Pro, Business and Enterprise side by side, each with its price and what it includes. Monthly and Yearly switch the prices between billing periods. Your plan has the Your plan badge, or On trial during a trial. The button under another plan chooses it, such as
Choose Pro…, and Move to Free… cancels your plan. Enterprise readsBy quote, and its Contact sales opens the contact page. - Referrals
- Your referral link and the credit it has earned, while Coritan gives credit for referrals (Earn credit with referrals).
An order or a change that waits for payment shows Waiting for payment at the top of the tab, with Pay invoice. While a paid plan is suspended for an unpaid invoice, the top of the tab reads Your Pro plan is on hold, with Pay invoice.
Home shows the same Your plan card, with fewer meters and the next plan's price. Its Change plan… opens the Plan tab (Home).
With the API
Section titled With the APIRead your plan
Section titled Read your planGET /account/plan returns your plan, the plans you can choose and your free trial:
curl https://api.coritan.com/api/v1/account/plan \
-H "Authorization: Bearer $CORITAN_TOKEN"
This account is on Free, plans are open on it, and it has not had a trial:
{
"plan": {
"key": "free",
"name": "Free",
"source": "free",
"status": "active",
"renews_at": null,
"ends_at": null,
"trial_ends_at": null,
"service_id": null,
"billing_cycle": null
},
"available": [
{
"key": "free",
"name": "Free",
"prices": {"monthly": 0.0, "annually": 0.0},
"popular": false,
"orderable": false,
"product_id": null,
"pricing_ids": {"monthly": null, "annually": null}
},
{
"key": "plan-pro",
"name": "Pro",
"prices": {"monthly": 12.0, "annually": 120.0},
"popular": true,
"orderable": true,
"product_id": 212,
"pricing_ids": {"monthly": 540, "annually": 541}
},
{
"key": "plan-business",
"name": "Business",
"prices": {"monthly": 39.0, "annually": 384.0},
"popular": false,
"orderable": true,
"product_id": 213,
"pricing_ids": {"monthly": 542, "annually": 543}
},
{
"key": "plan-enterprise",
"name": "Enterprise",
"prices": {"monthly": null, "annually": null},
"popular": false,
"orderable": false,
"product_id": 214,
"pricing_ids": {"monthly": null, "annually": null}
}
],
"trial": {"available": true, "plan": null, "ends_at": null, "status": null},
"enabled": true,
"pending": null,
"suspended": null
}
plan.keyfree,plan-pro,plan-businessorplan-enterprise.plan.sourcepaid,trialorfree.plan.statusactive,cancelling(the plan ends atends_at) ortrialing. A paid plan has itsservice_id, itsbilling_cycleand the date itrenews_at.available- Free and each plan on sale, with its prices in US dollars for each billing cycle. The prices in this example may differ from today's. A plan our sales team sells has no prices, and
orderableisfalse. The dashboard marks the plan whosepopularistruewith a Popular badge. Each plan also carries itslimits, shaped like thelimitsbelow, before any add-on. On Enterprise, the allowances its agreement sets arenull:mailboxes,mail_domains,sending_monthly,object_storage_gbandsnapshot_storage_gb. This example leaveslimitsout. trial- Whether the account can start its one free trial now (
available), and the trial it had: itsplan, when itends_atand itsstatus. enabled- Whether account plans are open on your account (Plans open in stages).
pending- An order or a plan change waiting for payment:
kind(orderorchange),service_id,plan,name,billing_cycle,invoice_idandamount_due.nullwhen there is none. suspended- A plan suspended for an unpaid invoice:
service_id,plan,name,invoice_idandamount_due.nullwhen there is none.
Read your limits and usage
Section titled Read your limits and usageGET /account/entitlements returns what your plan and add-ons allow, and what the account uses:
curl https://api.coritan.com/api/v1/account/entitlements \
-H "Authorization: Bearer $CORITAN_TOKEN"
This answer is shortened: limits holds every entitlement.
{
"plan": {"key": "free", "name": "Free", "source": "free", "status": "active", "renews_at": null, "ends_at": null, "trial_ends_at": null, "service_id": null, "billing_cycle": null},
"limits": {
"websites_max": 3,
"load_balancers_max": 1,
"team_members": 1,
"mail_domains": 1,
"mailboxes": 5,
"mailbox_gb": 1,
"sending_monthly": 3000,
"object_storage_gb": 10,
"trial_available": true
},
"usage": {
"websites_max": 3,
"load_balancers_max": 0,
"mailboxes": 2,
"mail_domains": 1,
"sending_monthly": 412,
"object_storage_gb": 1.5
},
"over_limit": [],
"enforced": true
}
limits- Every entitlement: a number, where
-1means unlimited;trueorfalsefor a feature; or a word forsupport_level. An add-on you have adds to its entitlement. On Enterprise, your agreement setsmailboxes,mail_domains,sending_monthly,object_storage_gbandsnapshot_storage_gb, within what the included services can hold (What each plan includes). usage- The counts Coritan measures: websites and load balancers; the mailboxes and mail domains of your included Mail Hosting; the emails your included SMTP Relay sent this month; and the GB your included Object Storage holds. A count for an included service you have not set up is left out.
over_limit- Each count above its limit, as
{entitlement, limit, used}. enforced- Whether the limits apply to your account (Plans open in stages).
audit_log says whether your plan includes the activity log. limits also names uptime_sla, a feature that no product reads yet, which changes nothing on your account. What each plan includes lists every limit Coritan applies.
Check whether plans apply
Section titled Check whether plans applyGET /features needs no authentication. plans_v2 says whether account plans apply to the account whose token you send, or, without a token, to an account created now. flags says which areas the dashboard shows.
curl https://api.coritan.com/api/v1/features
This answer is shortened:
{
"flags": {"vps": true, "mail": true, "storage": true, "dedicated": false},
"plans_v2": true
}
API operations on this page
| Method | Path | What it does |
|---|---|---|
GET | /api/v1/account/plan | Your plan, the plans you can choose and your free trial |
GET | /api/v1/account/entitlements | What your plan and add-ons let your account have, and what it uses |
GET | /api/v1/features | The dashboard areas this storefront shows, and whether account plans apply |