# 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.

Source: https://www.coritan.com/docs/account/referrals/

In the dashboard:

- /dashboard/billing/plan: https://www.coritan.com/dashboard/billing/plan

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.

## How a referral earns credit

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](/docs/billing/add-credit/#how-coritan-spends-credit)).

## 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.

## Before you begin

- Account plans are open on your account ([Plans open in stages](/docs/billing/account-plans/#plans-open-in-stages)). Before they open, read your link through the API ([With the API](#with-the-api)).

## Share your link

1. In the [dashboard](https://www.coritan.com/dashboard/billing/plan), 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.

## Result

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](/docs/billing/transactions/)).

## Related

- [Use a promo code](/docs/billing/promo-codes/)
- [Add credit to your balance](/docs/billing/add-credit/)
- [Create an account](/docs/get-started/create-an-account/)

## With the API

You need an access token for the account. [Make your first API request](/docs/get-started/first-steps-with-the-api/) shows how.

### Get your referral link

[`GET /account/referrals`](/docs/api/reference/client/promotions/#op-get-api-v1-account-referrals) returns your link, the terms and the accounts you referred. Coritan makes your code the first time you ask:

```bash
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.

### Statuses

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

### Sign up with a referral code

[`POST /auth/register`](/docs/api/reference/client/authentication/#op-post-api-v1-auth-register) takes a referral code in `referral_code`, beside the fields [Create an account](/docs/get-started/create-an-account/#with-the-api) lists. A code that does not count is ignored, and the account is created without it.

## API

- `GET /api/v1/account/referrals`: The account's referral link, the terms, and the accounts it referred (https://www.coritan.com/docs/api/reference/client/promotions/#op-get-api-v1-account-referrals)