Hanzo Referral

How It Works

Feedback
Get your referral code. Navigate to console.hanzo.ai and open the Referral tab. Your unique code is generated automatically when you create an account.
Feedback
Share your link. Send https://hanzo.ai/signup?ref=YOUR_CODE to anyone who would benefit from the platform -- colleagues, open source collaborators, conference attendees, newsletter subscribers.
Feedback
Friend signs up. When someone creates an account using your referral link, both you and your referral receive credits. Credits are applied to the referred user's account immediately and to yours within 24 hours.
Feedback
Revenue share accumulates. At Growth tier and above, you earn a percentage of the referred user's monthly spend. Revenue share is calculated at the end of each billing cycle and credited to your account on the first of the following month.
Feedback
Tier up. As your successful referral count grows, you automatically advance to higher tiers with larger per-referral credits and higher revenue share percentages.

Tiers

Feedback
Referral count is the total number of unique users who signed up with your code and completed at least one billable API call within 30 days of signup.
Feedback
Credit per referral is awarded to both the referrer and the referred user. The referred user always receives $20 regardless of the referrer's tier.
Feedback
Revenue share is calculated on the referred user's net spend (after credits and discounts) and paid out monthly.
Feedback
Max credit balance is the ceiling on unredeemed referral credits in your account at any point in time. Earned credits beyond this cap are forfeited.
Feedback
Credit expiry is measured from the date each credit is awarded. Partner-tier credits never expire.
Feedback
Tier advancement is one-way. Once you reach a tier, you keep it even if future referral volume drops.

API Reference

Create Referral Link

POST /api/v1/referrer

curl -X POST https://api.hanzo.ai/v1/referrer \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "twitter",
    "campaign": "launch-week-2026"
  }'

{
  "id": "ref_01HX9K3V2M7NQRST4BCDE5FG6H",
  "code": "zach42",
  "url": "https://hanzo.ai/signup?ref=zach42",
  "channel": "twitter",
  "campaign": "launch-week-2026",
  "created_at": "2026-03-22T00:00:00Z"
}

Get Referrer Profile

GET /api/v1/referrer/me

curl https://api.hanzo.ai/v1/referrer/me \
  -H "Authorization: Bearer $HANZO_API_KEY"

{
  "id": "ref_01HX9K3V2M7NQRST4BCDE5FG6H",
  "code": "zach42",
  "tier": "pro",
  "referral_count": 87,
  "credit_balance_cents": 435000,
  "credit_max_cents": 2000000,
  "credit_expiry_days": 365,
  "revenue_share_pct": 5.0,
  "revenue_share_total_cents": 128400,
  "revenue_share_pending_cents": 3200,
  "referrals": {
    "total": 87,
    "qualified": 82,
    "pending": 5
  },
  "created_at": "2025-06-15T00:00:00Z"
}

Validate Referral Code

GET /api/v1/referrer/code/:code

curl https://api.hanzo.ai/v1/referrer/code/zach42

{
  "valid": true,
  "code": "zach42",
  "referrer_name": "Zach",
  "credit_amount_cents": 2000,
  "tier": "pro"
}

Claim Referral

POST /api/v1/referral/claim

curl -X POST https://api.hanzo.ai/v1/referral/claim \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "zach42"
  }'

{
  "id": "claim_01HX9M4W3N8OPQRS5TUVW6XY7Z",
  "code": "zach42",
  "referrer_id": "ref_01HX9K3V2M7NQRST4BCDE5FG6H",
  "referred_user_id": "usr_01HX9M4W3N8OPQRS5TUVW6XY7Z",
  "credit_cents": 2000,
  "status": "credited",
  "created_at": "2026-03-22T12:00:00Z"
}

SDK Usage

Python

from hanzo import Client

client = Client(api_key="your-hanzo-api-key")

# Create referral link
referrer = client.referral.create(channel="blog")
print(f"Share this: {referrer.url}")

# Check your stats
me = client.referral.me()
print(f"Tier: {me.tier}, Referrals: {me.referral_count}")
print(f"Credits: ${me.credit_balance_cents / 100:.2f}")
print(f"Revenue share earned: ${me.revenue_share_total_cents / 100:.2f}")

TypeScript

import Hanzo from '@hanzo/node';

const hanzo = new Hanzo({ apiKey: process.env.HANZO_API_KEY });

// Create referral link
const referrer = await hanzo.referral.create({ channel: 'newsletter' });
console.log(`Share this: ${referrer.url}`);

// Check your stats
const me = await hanzo.referral.me();
console.log(`Tier: ${me.tier}, Referrals: ${me.referral_count}`);

Go

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/hanzoai/hanzo-go"
)

func main() {
    client := hanzo.NewClient(hanzo.WithAPIKey("your-hanzo-api-key"))

    // Create referral link
    ref, err := client.Referral.Create(context.Background(), &hanzo.ReferralCreateParams{
        Channel: hanzo.String("meetup"),
    })
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Share this: %s\n", ref.URL)

    // Check your stats
    me, err := client.Referral.Me(context.Background())
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("Tier: %s, Referrals: %d\n", me.Tier, me.ReferralCount)
}

Open Source Fund

How Attribution Works

Feedback
SBOM generation. Every Hanzo release produces a Software Bill of Materials listing all dependencies and their versions.
Feedback
Git blame mapping. For first-party and forked repositories, line-level authorship is extracted from git history. Each contributor's share is proportional to the lines of code they authored that remain in the current release.
Feedback
Component weighting. Not all code is equal. Components are weighted by criticality:

Feedback
Monthly payouts. On the first of each month, the fund is distributed proportionally across all eligible contributors. Minimum payout threshold is $50 -- amounts below this roll over to the next month.

Eligibility

Feedback
You must have a merged pull request in a Hanzo open source repository (github.com/hanzoai).
Feedback
You must register your payment details at console.hanzo.ai/contributor.
Feedback
Your contributions must be in the current SBOM (code that has been removed is no longer eligible).
Feedback
Automated commits (bots, CI, bulk renames) are excluded from attribution.

Register as a Contributor

# Via CLI
hanzo contributor register --github-username your-username

# Or visit the console
open https://console.hanzo.ai/contributor

Fraud Prevention

Feedback
Self-referral. Creating multiple accounts to refer yourself. Accounts are linked by email domain, IP address, browser fingerprint, and payment method.
Feedback
Fake accounts. Referring accounts that never make a billable API call. Referrals only qualify after the referred user completes at least one billable action within 30 days.
Feedback
Incentive abuse. Offering cash, gift cards, or other direct compensation in exchange for signups, beyond sharing the platform credit that Hanzo provides.
Feedback
Trademark misuse. Misrepresenting yourself as a Hanzo employee, partner, or official representative.
Feedback
Click fraud. Using bots, scripts, or paid click farms to generate signups.
Feedback
Credit cycling. Referred accounts that exist only to consume credits and never convert to paid usage.

Related Services

Billing, credit ledger, and subscription management powering referral payouts

Identity resolution and OIDC authentication for referrer and referred users

Attribution analytics, conversion funnels, and referral campaign tracking

Dashboard for managing referral codes, viewing stats, and tracking payouts