Validate an invitation code for a new customer account.

Check if an invitation code is valid and what reward is offered. This is typically used during the registration process.

Account & Settings Account

Context

Used in the dashboard

/signup /signup/en

Path Parameters

code string required Example: 5EY4XVJF

code parameter

Headers

Accept Example
Content-Type Example

Responses

200
data object required
data.referrerName string required · Example: Jonah
data.reward object required
data.reward.amount integer required · Example: 250
data.reward.currency string required · Example: SEK
data.reward.expiresInDays integer required · Example: 60
data.valid 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/validate/{code}
For AI assistants
cURL 
curl -X GET "https://cloud.hostup.se/api/referral/validate/5EY4XVJF" \
  -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": {
    "valid": true,
    "referrerName": "Jonah",
    "reward": {
      "amount": 250,
      "currency": "SEK",
      "expiresInDays": 60
    }
  }
}