Skip to content
Coritan Docs

Start a free trial

Try the Pro or Business plan free for 14 days, once per account and with no payment method, and learn what happens when the trial ends.

View as Markdown

In the dashboard

A free trial gives your account the Pro or Business plan for 14 days. It needs no payment method and raises no invoice. Each account can have one trial, of one plan, ever. You start it from the plan page, from the prompt that opens when you reach a plan limit, or through the API (With the API). Only Admin and Billing members can start one.

  • Account plans are open on your account (Plans open in stages).
  • The account is on the Free plan and has never had a trial. The plan page offers Start a free trial only then.
  1. In the dashboard, open the plan page: select Manage plan on the Your plan card of the Dashboard.
  2. On the Your plan card, select Start a free trial. The page opens at /dashboard/plan/trial. A link such as /dashboard/plan?trial=plan-business opens it with that plan chosen.
  3. Under Plan to try, choose Pro or Business. Each choice lists the first of the plan's limits (What each plan includes). The What the trial gives card names the plan, the length, the cost and the limit of one trial for each account.
  4. Complete the verification check under Verification, if the page shows one.
  5. Select the button under What the trial gives, such as Start Business trial.

When the account cannot start a trial, the page opens with A free trial is not available and says why, such as This account already used its free trial, on Pro. Each account has one. Its button then orders the plan instead.

The dashboard lands on the plan page and says Your Business trial runs until October 10, 2026. The Your plan card shows the plan with a Free trial badge and the date the trial ends, such as Your free trial ends on Oct 10, 2026. The account then moves back to the Free plan unless you choose a plan. Under Plans, the plan you are trying has the On trial badge.

The account has the plan's limits at once. Coritan also moves your included services up to the plan's size. A trial includes Server access while it runs.

Coritan emails you 4 days before the trial ends, 1 day before, and when it has ended.

To keep a plan, order it before the trial ends: select the button under the plan on the plan page, such as Choose Business (Order Pro or Business). The trial ends when the plan starts, whichever plan you order.

If you do nothing, the account returns to the Free plan when the trial ends. Coritan deletes nothing: what is above the Free plan's limits keeps working, and you cannot add more of it (Moving to a smaller plan).

To end the trial early, select End trial on the Your plan card, then End trial on the End your free trial page. Move to Free under Free in Plans opens the same page.

Warning

A trial you end early cannot be restarted. Each account has one trial, ever.

In the dashboard, the page shows the reason in an alert titled Could not start your trial. Over the API, it is the answer's detail, with the status in the first column.

Status detail Cause
403 {"code": "plans_not_open", ...} Account plans are not open on your account yet.
403 {"error": "turnstile_failed", ...} The verification check is on, and turnstile_token is missing or did not pass. The dashboard shows The verification check did not pass. Complete it and try again.
409 This account has already had its free trial. The account had a trial before, whatever became of it.
409 This account already has the Pro plan. The account has Pro or Business. A trial is for an account on Free.
422 A free trial is for the Pro or Business plan. plan is not plan-pro or plan-business.
429 {"error": "rate_limited", "action": "account_plan.trial", ...} You tried to start a trial 5 times in an hour. Each request for Pro or Business counts, also one whose verification check failed. The limit is separate from the one on free orders, so trying uses none of those. Wait the number of seconds in retry_after_seconds (3600), then try again. The dashboard shows Too many requests for this action. Try again later.
Complete the verification check to continue.
You pressed the button before the check finished. Complete the check, then select the button again.

You need an access token for the account (Access and refresh tokens). While the verification check is on, the request needs a turnstile_token, which only the check on a web page produces (The verification check).

  1. Check that the account can start its trial:

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

    The answer has "trial": {"available": true, ...} when it can.

  2. Start the trial with POST /account/plan/trial. plan is plan-pro or plan-business:

    Shell
    curl -X POST https://api.coritan.com/api/v1/account/plan/trial \
      -H "Authorization: Bearer $CORITAN_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"plan": "plan-business", "turnstile_token": "the-widget-answer"}'
    

The answer is 201, with your plan as GET /account/plan returns it:

JSON
{
  "plan": {
    "key": "plan-business",
    "name": "Business",
    "source": "trial",
    "status": "trialing",
    "renews_at": null,
    "ends_at": "2026-10-10T09:30:00+00:00",
    "trial_ends_at": "2026-10-10T09:30:00+00:00",
    "service_id": null,
    "billing_cycle": null
  },
  "trial": {"available": false, "plan": "plan-business", "ends_at": "2026-10-10T09:30:00+00:00", "status": "active"},
  "message": "Your Business trial runs until October 10, 2026."
}

To end the trial early, send POST /account/plan/cancel. The answer's status is trial_ended.

API operations on this page

MethodPathWhat it does
POST/api/v1/account/plan/trialStart your account's one free trial of Pro or Business