View and suggest targets for your referral bonus

See which of your services are eligible to be the target service for a referral bonus. You can also view the current target service and get suggestions for a new one based on cost and validity to maximize your bonus.

Account & Settings Account

Context

Used in the dashboard

/referral

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.accounts array<object> required · Example: [{"accountId":"20000","name":"VPS XS","category":"vps","monthlyCost":39,"currency":"SEK...
data.accounts[].accountId string required · Example: 20000
data.accounts[].category string · Example: vps
data.accounts[].currency string · Example: SEK
data.accounts[].expires string · nullable required · Example: null

Nullable: may be null when not applicable.

data.accounts[].monthlyCost integer · Example: 39
data.accounts[].name string required · Example: VPS XS
data.accounts[].nextDue string · enum required · Example: 2026-02-23
0000-00-00
2026-02-05
2026-02-17
2026-02-19
2026-02-23
2026-02-28
2026-03-04
2027-01-09
2027-01-12
data.accounts[].status string required · Example: Active
data.maxRewardTargetMonthlyCost integer · Example: 600
data.suggestedAccountId string required · Example: 16799
data.targetAccountId string · nullable required · Example: null

Nullable: may be null when not applicable.

data.targetValid boolean required · Example: true
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/reward-target
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/referral/reward-target" \
  -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": {
    "targetAccountId": null,
    "targetValid": true,
    "suggestedAccountId": "16799",
    "maxRewardTargetMonthlyCost": 600,
    "accounts": [
      {
        "accountId": "20000",
        "name": "VPS XS",
        "category": "vps",
        "monthlyCost": 39,
        "currency": "SEK",
        "status": "Active",
        "nextDue": "2026-02-23",
        "expires": null
      }
    ]
  }
}