Referral History

GET

https://tunnelsats.com/api/referral/history

Lists up to 50 paid or claimed subscriptions that used your referral code, newest first. bonus_earned is the number of bonus months the referral qualifies for based on the purchased duration (1 → 0, 3 → 1, 6 → 2, 12 → 3). Returns an empty list if you have no code yet. Rate limit: 30 requests/min per account.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Responses

🟢200

application/json

Referral history

Bodyapplication/json

🟠401

🟠429

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/referral/history' \
--header 'Accept;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "history": [
        {
            "date": "2026-01-01 19:40:00",
            "duration_purchased": 3,
            "bonus_earned": 1
        },
        {
            "date": "2025-12-25 10:00:00",
            "duration_purchased": 12,
            "bonus_earned": 3
        }
    ]
}

Modified at 2026-09-27 20:22:45

Get Referral Code

Lightning Node Network Address Discovery