Referrals
Share your link. When a company signs up with it and adds $10 or more of credit for the first time, you both get credit equal to what they added: at least $25 and at most $500 each. Theirs is added on top of what they bought. A $10 top-up gives you both $25; $137.42 gives you both $137.42; $2,000 gives you both $500.
- Your link is
https://withruntime.com/r/<code>, andhttps://withruntime.com/?ref=<code>works too. Owners find it on the account's Overview and Usage & billing pages, or ask for it with the API, an SDK, the CLI or MCP (below). The code belongs to your organization and never changes. - Showing someone what you built? A preview link is a good way; the answer to creating one says so. Runtime adds nothing to the pages a preview serves: no badge, no banner.
- The link has to be followed before the company is created. It is remembered for 30 days in a cookie that holds only the code, and it carries through Google and email sign-in.
- The reward is paid once per referred company, on its first top-up of $10 or more, and matches that top-up. Later top-ups pay nothing more. Free trial time never counts.
- You can earn up to $10,000 of referral credit per calendar year (UTC). Past that, the company you referred still gets its credit; yours is recorded as over the cap.
- Referring yourself does not count: not your own organization, not another address of yours, not an address on the same company email domain (a shared provider such as gmail.com is not one company), and not a first top-up paid with a card your organization has paid with. A code that does not count never stops anyone signing up.
- If the qualifying top-up is partly refunded, the reward is matched again to what stands, and both sides give back the difference. If less than $10 stands, or it is disputed, both rewards are taken back. Either way, only what is still unspent is taken.
- Referral credit is spent like any other credit. It can't be exchanged for cash or refunded.
Read your link and what it earned
TypeScriptimport { Runtime } from "withruntime";const runtime = new Runtime();const r = await runtime.referrals.get();console.log(r.link, r.signedUp, r.paid, r.earnedMicros);Pythonfrom withruntime import Runtimer = Runtime().referrals.get()print(r["link"], r["capRemainingMicros"])Terminalnpx withruntime referralsOver HTTP it is GET /v1/referrals, and over MCP the runtime_referrals_get
tool. Both answer the same fields:
| Field | Meaning |
|---|---|
code, link |
Your code and the link to share |
signedUp |
Companies that signed up with your link |
pending |
Of those, the ones that have not made a first top-up yet |
paid, capped |
Rewards paid, and how many of those the yearly cap cut short |
rewardMicros, maxRewardMicros |
The least and the most each side gets per referral |
reversed |
Rewards taken back because the qualifying top-up was refunded |
earnedMicros |
Referral credit you kept, all time |
earnedThisYearMicros |
What counts against this year's cap |
capRemainingMicros |
What you can still earn this year |
referredBy |
Whether your own organization joined through a link, and its credit |
Money is integer microdollars in strings: "25000000" is $25.