Skip to content
Coritan Docs

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.

View as Markdown

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, the email and sending it gets at no charge, and the Object Storage it uses free each month. Each account has one plan: Free, Pro, Business or Enterprise. Servers, instances, web services, storage and IP addresses are services of their own. You order them on any plan, and each is billed on its own.

Coritan opens account plans to accounts in stages. Until they open on yours:

  • GET /account/plan answers "enabled": false, and GET /account/entitlements answers "enforced": false.
  • The limits on this page do not refuse anything.
  • Ordering, changing or trying a plan answers 403 with {"code": "plans_not_open", "message": "Plans are not open on this account yet."}.
  • The dashboard keeps its earlier layout: Billing in the sidebar and no plan page, Support and Organizations in the sidebar, and the overview's four figures in place of the Dashboard's cards (The dashboard).

You can cancel a plan and set up the services a plan includes at every stage.

Free
Every account starts on Free. It costs nothing, needs no payment method and has no end date (The Free plan).
Pro and Business
Plans with higher limits, billed monthly or yearly. You can try either one free once, and order one or move between them. GET /account/plan lists each plan's current prices under available.
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.

An active Pro, Business or Enterprise plan 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 your 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).

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
Traffic and 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
Server access, for Cloud Compute instances, game servers and databases Not included, and an add-on adds it Included Included Included
Object Storage free each month 10 GB-month 250 GB-month 1,024 GB-month Set in your agreement
Object Storage Class A operations free each month 1 million 1 million 1 million 1 million
Object Storage Class B operations free each month 10 million 10 million 10 million 10 million
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 and each static site that keeps a plan price. A static site you order on your own account is billed by use, costs nothing to serve and is not counted. The example.com zone and a web proxy for www.example.com count as one website. A coritan.gg name is a DNS zone too. An organization's static site counts for the organization's owner, who pays for it. Coritan checks the limit when you add a domain you already own, claim a coritan.gg name, create a web proxy or order a static site.
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 and deployments. A deployment's rule counts once, however many of its addresses carry it. 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).
Cache settings, your own certificates and wildcard certificates
Changing how Coritan's network caches a website's files and clearing the cache (Speed up a website with the cache), uploading a certificate of your own (Upload your own certificate) and ordering a wildcard (Issue a certificate with Coritan DNS).
Traffic and query history
How far back a website's web proxy traffic and its DNS query counts go. Free shows the last 24 hours (View web proxy traffic, 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 and SMTP Relay
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.
Server access
What an account needs to order a Cloud Compute instance, a game server or a database. Pro, Business and Enterprise include it. A Free account adds it as an add-on for $4.50 a month, in the same order as its first instance or game server. It includes data out only: 1,000 GB in North America and Europe and 500 GB elsewhere each month, shared by the account's instances and game servers (Usage rates). A web deployment needs no plan, and every account gets some use of it free each month (How usage billing works).

When you buy Pro or Business, the add-on ends at once and Coritan adds its unused days to your account credit. A trial includes Server access for 14 days and leaves the add-on alone (When a plan includes Server access). When the add-on lapses, the servers you run keep running and new ones are refused.

Object Storage free each month
The storage, in GB-months, and the Class A and Class B operations that your account uses at no charge each calendar month. Every pay as you go Object Storage service on the account draws on the same amounts, and we bill the use above them at the Object Storage rates. An Extra Object Storage 250 GB add-on you already have adds 250 GB-month (Free each month).
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.

What 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:

JSON
{
  "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.

Your 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.
  • Your instances, game servers and databases keep running. Free does not include Server access, so the amounts it includes stop, and what they use is billed in full, until the account has Server access again. A new instance, game server or database needs it (How usage billing works). The preview says how many servers this affects (Preview a plan).
  • Object Storage keeps every file. Your account's free storage each month becomes the new plan's, and we bill the storage above it at the Object Storage rate (Free each month).
  • 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 your plan is suspended for an unpaid invoice, because the account then has the Free plan's limits.

Before you confirm a smaller plan, its page 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}, and gives the effect on Server access in server_access (Preview a plan).

Pro and Business bill monthly or yearly, and you can move between them while the plan is active. The new period starts today, and the unused days of the period you paid for count towards it:

  • Monthly to yearly: Coritan invoices the year and takes the unused days of the current month off the invoice. A Pro plan at $12 a month with 17 of 30 days left pays $120 less $6.80, so $113.20, and the plan then renews at $120 a year, one year from today.
  • Yearly to monthly: It applies at once. The unused days of the year pay the first month, less the day Coritan keeps back from every credit, and the rest goes to your account credit. A Pro plan at $120 a year with 200 of 365 days left has $65.42 unused, so the first month at $12 is covered and $53.42 goes to your credit. When the unused days do not cover the month, you pay the difference.
  • The plan can change at the same time, such as Pro monthly to Business yearly.
  • A plan with an unpaid renewal invoice cannot switch until you pay it, because the new period would be billed on top of that renewal.

In the dashboard, the Your plan card on the plan page has Switch to yearly billing or Switch to monthly billing, and every plan change page has Monthly and Yearly under Billing period (Change your billing period). Over the API, POST /account/plan takes the other billing_cycle, and its preview prices the move (Switch between monthly and yearly billing).

Once plans open on your account, the plan has a page of its own, at Plan. Select Manage plan on the Your plan card of the Dashboard, or open the search (Ctrl K) and choose Your plan. From the top, the page shows:

Your plan
The same card as on the Dashboard: 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, a Cancelling badge a plan you cancelled, and a red badge such as Pro on hold a plan that waits for an unpaid invoice. A plan on hold, or an order or change that waits for payment, says so on the card in one line, and Pay invoice is its first button. During a trial, a bar shows the days left and turns amber at four days or fewer, with a Choose button for the plan. Its other buttons start or end your trial, and cancel or keep your plan. Each one opens a page of its own (Start a free trial, Choose or change your account plan). The meters are in What your account uses.
Server access
On a Free account, what Server access is for, what it includes and its price for the period Plans shows, with Add Server access, which opens the page that buys it (Server access). When the account holds the add-on, the card shows Active, its price and Renews on, with Cancel Server access. A Pro, Business or trial account has no such card, because its plan includes Server access, and its Your plan card says Includes Server access.
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 as Counted once you set up the email your plan includes. (Set up the services your plan includes). Object Storage compares the storage your account has used so far this month, in GB-months, with the storage it uses free each month. Storage above that is billed, and it refuses nothing (Free each month).
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. A plan that includes Server access says what it costs over Free with Server access, such as $7.50 a month more than Free with Server access. Its rows include the first reply target for support and the custom firewall rules, instances with automatic backups and Shield Custom Profiles the plan pays for. The button under another plan opens its change page, such as Choose Pro, and Move to Free opens the page that cancels your plan. Each page prices the change, takes a promo code and takes the payment (Choose or change your account plan). Enterprise reads By 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).

Only Admin and Billing members can change the plan. A Read only member sees the plans without the buttons that choose one, and a Technical member sees the plan and what the account uses, without prices or buttons. Buying Server access is for Admin members, because it adds a service to the account (Team members).

The Dashboard shows the same plan in its Your plan card, with the next plan's price and the six meters closest to their limit. On a Free account its Upgrade to Pro opens the page that orders Pro, and Start a free trial opens the trial page while the account can still start one (The Dashboard).

Links that opened the plan tab before keep working. /dashboard/billing/plan and /dashboard/plan with ?plan=plan-pro&cycle=annually, ?trial=plan-pro or ?addon=server-access open the change page, the trial page or the Server access page, with the plan and billing period the link names.

GET /account/plan returns your plan, the plans you can choose and your free trial:

Shell
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:

JSON
{
  "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,
    "currency": "USD"
  },
  "available": [
    {
      "key": "free",
      "name": "Free",
      "prices": {"monthly": 0.0, "annually": 0.0},
      "currency": "USD",
      "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},
      "currency": "USD",
      "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},
      "currency": "USD",
      "popular": false,
      "orderable": true,
      "product_id": 213,
      "pricing_ids": {"monthly": 542, "annually": 543}
    },
    {
      "key": "plan-enterprise",
      "name": "Enterprise",
      "prices": {"monthly": null, "annually": null},
      "currency": "USD",
      "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.key
free, plan-pro, plan-business or plan-enterprise.
plan.source
paid, trial or free.
plan.status
active, cancelling (the plan ends at ends_at) or trialing. A plan you pay for has its service_id, its billing_cycle and the date it renews_at.
plan.currency
The currency of every price on the page, such as USD.
available
Free and each plan on sale, with its prices for each billing cycle in its currency, such as USD. The prices in this example may differ from today's. A plan our sales team sells has no prices, and orderable is false. The dashboard marks the plan whose popular is true with a Popular badge. Each plan also carries its limits, shaped like the limits below, before any add-on. On Enterprise, the allowances its agreement sets are null: mailboxes, mail_domains, sending_monthly, object_storage_gb and snapshot_storage_gb. This example leaves limits out.
trial
Whether the account can start its one free trial now (available), and the trial it had: its plan, when it ends_at and its status.
enabled
Whether account plans are open on your account (Plans open in stages).
pending
An order or a plan change waiting for payment: kind (order or change), service_id, plan, name, billing_cycle, invoice_id and amount_due. null when there is none.
suspended
A plan suspended for an unpaid invoice: service_id, plan, name, invoice_id and amount_due. null when there is none.

GET /account/entitlements returns what your plan and add-ons allow, and what the account uses:

Shell
curl https://api.coritan.com/api/v1/account/entitlements \
  -H "Authorization: Bearer $CORITAN_TOKEN"

This answer is shortened: limits holds every entitlement.

JSON
{
  "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,
    "object_storage_class_a": 1000000,
    "object_storage_class_b": 10000000,
    "trial_available": true
  },
  "usage": {
    "websites_max": 3,
    "load_balancers_max": 0,
    "mailboxes": 2,
    "mail_domains": 1,
    "sending_monthly": 412,
    "object_storage_gb": 1.5,
    "object_storage_class_a": 18420,
    "object_storage_class_b": 221034
  },
  "over_limit": [],
  "enforced": true
}
limits
Every entitlement: a number, where -1 means unlimited; true or false for a feature; or a word for support_level. An add-on you have adds to its entitlement. On Enterprise, your agreement sets mailboxes, mail_domains and sending_monthly, within what the included services can hold, and object_storage_gb and snapshot_storage_gb (What each plan includes). object_storage_gb, object_storage_class_a and object_storage_class_b are the Object Storage free amounts each month: GB-months of storage, then Class A and Class B operations. Use above them is billed, so they refuse nothing and never appear in over_limit.
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-months and the Class A and Class B operations that your pay as you go Object Storage has used this month, up to the last hour we rated. A count for an included service you have not set up is left out, and so is an Object Storage meter with nothing rated this month.
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.

GET /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.

Shell
curl https://api.coritan.com/api/v1/features

This answer is shortened:

JSON
{
  "flags": {"vps": true, "mail": true, "storage": true, "dedicated": false},
  "plans_v2": true,
  "gates": {"mail_enabled": true, "mail_cluster_active": true, "relay_cluster_active": true, "storage_regions": ["fra"], "ips_stock": true, "referrals": true, "github_app": false, "leads": true}
}

gates says whether what a page may promise is in place right now. See Read what Coritan offers without signing in for each gate.

Read the plans without signing in

Section titled Read the plans without signing in

GET /plans needs no authentication and answers the same for everyone. It lists Free, Pro, Business and Enterprise with their prices and limits:

Shell
curl https://api.coritan.com/api/v1/plans

This answer is shortened to one plan:

JSON
{
  "stage": "all",
  "open": true,
  "plans": [
    {
      "key": "plan-pro",
      "name": "Pro",
      "monthly_price": 12.0,
      "yearly_price": 120.0,
      "currency": "USD",
      "popular": false,
      "orderable": true,
      "limits": {"websites_max": 10, "mailboxes": 10, "support_level": "chat"},
      "features": ["cache_controls", "custom_certificates"]
    }
  ]
}

stage is who plans apply to (off, staff, new or all), and open says whether they apply to someone who signs up now: true for new and all. GET /features and GET /products answer a visitor the same way. A plan is orderable while open is true and the plan is on sale. Enterprise has no price, because our sales team sells it. limits is the plan's own value for each entitlement, as available in GET /account/plan lists them, and features names the limits that are true. The prices are the plan's list prices in currency, so they match what GET /account/plan shows signed in.

API operations on this page

MethodPathWhat it does
GET/api/v1/account/planYour plan, the plans you can choose and your free trial
GET/api/v1/account/entitlementsWhat your plan and add-ons let your account have, and what it uses
GET/api/v1/featuresThe dashboard areas this storefront shows, and whether account plans apply
GET/api/v1/plansThe account plans, their prices and what each allows