# Refer & Earn

> Find your referral code and distinguish explicit redemption, locked bonus credits and unsupported automatic attribution.

Canonical: https://theaimart.co/docs/referrals
Updated: 2026-10-08 · Guide version: 1.1

Refer & Earn displays a referral code, redeemed referral count and bonus-credit totals. Opening a link is not evidence that a reward has been redeemed.

## Retrieve and share your code

1. Sign in and open [Refer & Earn](/Dashboard/Referrals).
2. Copy your code or the displayed share link.
3. Explain that the recipient must complete an eligible account flow and redeem the code; do not promise an automatic purchase reward.

The read-only `GET /referral/stats` returns these fields:

```text
code, referral_count, credits_earned, reward_per_referral
```

The account's code can be generated when stats are first requested. These are redeemed-referral totals, not click, signup or purchase-funnel metrics.

## Redemption behavior

The backend accepts `POST /referral/redeem` with:

```json
{"code":"INVITER_CODE"}
```

This changes account state and is not a read-only test. It requires a signed-in user, rejects an invalid code, self-referral and a previously redeemed referral. The configured reward is granted to both accounts as locked bonus credits. It is not paid in cash and does not directly increase the spendable marketplace wallet.

## Attribution limitations

The dashboard currently shares a `/?ref=CODE` link. The separate `/invite/{code}` landing can set a referral cookie and offer an app deep link. The reviewed web signup flow does not automatically call the redemption endpoint. It does not establish cross-device attribution, a last-touch window, first-purchase revenue share or an automatic first-order discount.

The current web dashboard has no explicit redemption form. Contact support about an eligible redemption route instead of repeatedly signing up or requesting rewards. Reward eligibility and promotional terms need owner confirmation before you advertise them.

## Troubleshooting

No reward after a click can mean no redemption occurred. An already-redeemed error is not permission to create another account. Check the [wallet guide](/docs/wallet-and-credits) for the difference between paid credits, locked bonus credits and publisher earnings.

## Next

Read [Bundles & Referrals](/docs/bundles-and-referrals) and [Accounts & Authentication](/docs/accounts-and-auth).