Referrals

Inviting a friend creates an independent new household — a distinct concept from a family invite, which joins an existing household with a role. A redeemed referral credits both sides with bonus document/profile slots.

Get your referral code

GET/referrals/me

Get-or-create — the first call for a household mints its code; every later call returns the same one, with running totals.

curl https://api.dociya.com/referrals/me \
  -H "Authorization: Bearer $DOCIYA_ACCESS_TOKEN"

Preview a referral code

POST/referrals/previewno auth

Public, pre-auth — lets a signup screen show "Priya invited you" before the account exists. Pass the same code as referralCode on sign-up.

Parameters

codestringrequired

curl https://api.dociya.com/referrals/preview \
  -H "Content-Type: application/json" \
  -d '{ "code": "PRIYA-7X2" }'

Note

A redemption only confirms — and only then grants the bonus to both households — after the referred account's first successful document upload, not at bare signup. One redemption per new household, enforced server-side.