Skip to content
Coritan Docs

Earn credit with referrals

Share your referral link. Once an account that signed up with it has paid enough in invoices, both accounts get credit on their balance.

View as Markdown

In the dashboard

Every account has a referral link: the address of the sign-up page with your own referral code in it, such as https://www.coritan.com/sign-up?ref=7KQ2MXPA. An account that signs up with your code is linked to yours. Once that account has paid $10.00 in invoices, Coritan adds $10.00 to the credit balance of both accounts. These are the default terms and Coritan can change them, so read the current ones beside your link.

  1. Someone opens your link and signs up. The sign-up page says You are signing up with referral code 7KQ2MXPA., and keeps the code while they stay in that browser tab, so a reload does not lose it. Their account is linked to yours, with the status pending.
  2. They pay invoices. Every paid invoice counts, whether they paid it by card, PayPal or credit.
  3. When their paid invoices add up to the threshold ($10.00 by default), Coritan adds the credit ($10.00 by default) to both accounts and emails both of you. The referral's status becomes credited.

Each referred account earns credit once. The credit is in US dollars, as every credit balance is, and it pays for invoices and hourly services before any card is charged (How Coritan spends credit).

When a referral does not count

Section titled When a referral does not count

A sign-up goes ahead without a referral when:

  • the code is unknown, or the account behind it is closed;
  • the code is the person's own, or the two addresses are one mailbox, such as jane.doe+test@gmail.com and janedoe@gmail.com;
  • Coritan has switched referrals off.

An account can be referred only when it signs up. Coritan does not add a code to an account that already exists.

When a referred account reaches the threshold, Coritan voids the referral and adds no credit if either account is closed, or if the two accounts have saved the same card or PayPal account. Coritan staff can also void a referral before it earns credit.

  1. In the dashboard, select Plan and billing, then the Plan tab.
  2. On the Referrals card, select Copy link beside Your referral link.
  3. Send the link to the people you want to invite.

The card's description gives the current terms, such as When someone signs up with your link and pays $10.00 in invoices, you both get $10.00 of account credit. It also shows your Referral code, the number of Accounts referred and the Credit earned from them in all. The card is hidden while Coritan has referrals switched off.

The credit shows on the Transactions tab of Billing as Credit added, with Referral credit under Paid with. Its description is Referral credit for an account you referred on your account, and Referral credit for signing up with a referral link on the new one (Transactions and payment attempts).

You need an access token for the account. Make your first API request shows how.

GET /account/referrals returns your link, the terms and the accounts you referred. Coritan makes your code the first time you ask:

Shell
curl https://api.coritan.com/api/v1/account/referrals \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{
  "enabled": true,
  "code": "7KQ2MXPA",
  "link": "https://www.coritan.com/sign-up?ref=7KQ2MXPA",
  "credit_amount": "10.00",
  "threshold": "10.00",
  "currency": "USD",
  "referred": [
    {
      "email_masked": "m***@g***.com",
      "status": "pending",
      "created_at": "2026-09-24T10:31:02",
      "credited_at": null
    },
    {
      "email_masked": "j***@e***.com",
      "status": "credited",
      "created_at": "2026-09-02T14:05:11",
      "credited_at": "2026-09-20T08:12:40"
    }
  ],
  "referred_total": 2,
  "credited": 1,
  "earned": "10.00"
}
code and link
Your referral code, and the sign-up link to share. link is null while Coritan has referrals switched off.
credit_amount and threshold
What each account gets, and what the referred account must pay in invoices first, both in currency.
referred
Up to 200 accounts you referred, newest first, each with its status. Coritan masks their addresses.
referred_total, credited and earned
How many accounts you referred, how many of them earned credit, and the credit you earned from them in all.
Status Meaning
pending The account signed up with your code and has not paid enough yet.
credited Both accounts received the credit.
qualified The account paid enough while Coritan was giving no credit for referrals, so no credit was added.
void The referral no longer counts: one of the accounts closed, the two share a payment method, or Coritan staff voided it.

POST /auth/register takes a referral code in referral_code, beside the fields Create an account lists. A code that does not count is ignored, and the account is created without it.

API operations on this page

MethodPathWhat it does
GET/api/v1/account/referralsThe account's referral link, the terms, and the accounts it referred