Check your referral program eligibility status

See if you are eligible to invite friends through our referral program. You can also view your current status, the number of referrals you have, and potential rewards.

Account & Settings Account

Context

Used in the dashboard

/referral

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.bankIdVerified boolean required · Example: false
data.eligibilityReason string · Example: Requires Trust Tier 1+ (30 days + 500 SEK spent) OR BankID verification with 1 paid inv...
data.eligible boolean required · Example: false
data.link object · nullable required

Nullable: may be null when not applicable.

data.link.code string required · Example: 5EY4XVJF

Machine-readable error code.

data.link.createdAt string required · Example: 2026-02-10T00:00:00.000Z
data.link.url string required · Example: https://cloud.hostup.se/signup?ref=5EY4XVJF
data.rewards object required
data.rewards.appliedAfterFirstPayment boolean · Example: true
data.rewards.currency string · Example: SEK
data.rewards.hostingMaxMonths integer · Example: 6
data.rewards.maxRefereeMonths integer · Example: 6
data.rewards.maxReferrerMonths integer · Example: 6
data.rewards.maxRewardTargetMonthlyCost integer · Example: 600
data.rewards.referee integer · Example: 250
data.rewards.refereeMonths integer · Example: 2
data.rewards.referrer integer · Example: 500
data.rewards.referrerMonths integer · Example: 2
data.rewards.vpsMonths integer · Example: 1
data.stats object required
data.stats.availableCredit integer · Example: 0
data.stats.completedReferrals integer required · Example: 0
data.stats.lifetimeEarned string | integer · Example: 0.00
data.stats.lifetimeEarnedMonths integer · Example: 0
data.stats.lifetimeLimit integer · Example: 10000
data.stats.lifetimeLimitMonths integer · Example: 10000
data.stats.monthlyLimit integer required · Example: 5
data.stats.monthlyUsed integer required · Example: 0
data.stats.pendingReferrals integer required · Example: 0
data.trustTier integer required · Example: 0
requestId string required · Example: 2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba

Unique request identifier (UUID).

success boolean required · Example: true

True for successful responses.

timestamp string required · Example: 2026-02-10T00:00:00.000Z

ISO 8601 timestamp (UTC).

GET https://cloud.hostup.se/api/referral/status
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/referral/status" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"
Response 
{
  "success": true,
  "timestamp": "2026-02-10T00:00:00.000Z",
  "requestId": "2121ae20-bd9d-41e9-aeeb-5dd1dd1a24ba",
  "data": {
    "eligible": false,
    "eligibilityReason": "Requires Trust Tier 1+ (30 days + 500 SEK spent) OR BankID verification with 1 paid invoice",
    "trustTier": 0,
    "bankIdVerified": false,
    "link": null,
    "stats": {
      "monthlyUsed": 0,
      "monthlyLimit": 5,
      "lifetimeEarnedMonths": 0,
      "lifetimeLimitMonths": 10000,
      "pendingReferrals": 0,
      "completedReferrals": 0
    },
    "rewards": {
      "maxReferrerMonths": 6,
      "maxRefereeMonths": 6,
      "vpsMonths": 1,
      "hostingMaxMonths": 6,
      "maxRewardTargetMonthlyCost": 600,
      "appliedAfterFirstPayment": true
    }
  }
}