TunnelSats Public Wireguard API
  1. 🔐 Authenticated
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List Servers
      GET
    • Create Subscription
      POST
    • Check Status / Heal
      GET
    • Claim Subscription
      POST
    • Renew Subscription
      POST
    • Get Subscription Status
      POST
  • 🔐 Authenticated
    • List My Subscriptions
      GET
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
  • Cookbook
    • 🛠️ Automation & Code Examples
    • 🐚 Bash One-Liners
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
  1. 🔐 Authenticated

Referral History

GET
/api/referral/history
Retrieves a history of successful referrals (paid/claimed orders) that earned you bonus months.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params

Responses

🟢200
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://tunnelsats.com/api/referral/history' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "history": [
        {
            "date": "2026-01-01T19:40:00.000Z",
            "duration_purchased": 3,
            "bonus_earned": 1
        },
        {
            "date": "2025-12-25T10:00:00.000Z",
            "duration_purchased": 12,
            "bonus_earned": 3
        }
    ]
}
Modified at 2026-02-10 21:55:30
Previous
Create Referral Code
Next
💫 What is TunnelSats?
Built with