1. 🔐 Authenticated
TunnelSats Public Wireguard API
  • About our team
  • 📢 Public
    • List Available WireGuard Servers & Regions
      GET
    • Create a New WireGuard Subscription (Invoice Generation)
      POST
    • Claim WireGuard Configuration After Payment Settlement
      POST
    • Check subscription status via payment hash
      GET
    • Renew an Existing VPN Subscription (Anonymous)
      POST
    • Get Subscription & Bandwidth Status by WireGuard Public Key
      POST
    • Request Bandwidth Top-Up ($1 for +100GB)
      POST
  • 🔐 Authenticated
    • List Account Subscriptions (Authenticated)
      GET
    • Sync Subscription
      POST
    • Create Referral Code
      POST
    • Referral History
      GET
  • 🔧 Tools
    • Lightning Node Network Address Discovery
      POST
    • Universal Connectivity & Latency Probe
      POST
  • Announcements
    • 💫 What is TunnelSats?
    • 🚀 Introducing the TunnelSats Public API v1
    • How TunnelSats Leverages Public APIs for Confined VPN Management
  • Cookbook
    • 🛑 Error Codes & Troubleshooting
    • 🎁 Referral Program: Earn Bonus Months
    • 🚑 Node Health & Upkeep
    • 🛡️ Security & Authentication
    • 🛠️ Automation & Code Examples
    • ⚡ Bandwidth Top-Up ($1 for +100GB)
    • 🐚 Bash One-Liners
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • WireGuardConfig
    • ReferralCode
    • ReferralHistory
    • NodeLookup
    • ConnectivityResult
    • ApiError
    • RenewalOrder
    • BandwidthResetResponse
    • PublicKeyStatusResponse
    • ClaimResult
    • SubscriptionListItem
  1. 🔐 Authenticated

List Account Subscriptions (Authenticated)

GET
/api/public/v1/subscription/list

Request

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

Responses

🟢200OK
application/json
List of active subscriptions
Bodyapplication/json

🟠401Unauthorized
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://tunnelsats.com/api/public/v1/subscription/list' \
--header 'Accept;' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Example 1
{
    "subscriptions": [
        {
            "payment_hash": "a1b2c3d4e5f6...",
            "server_domain": "de2.tunnelsats.com",
            "server_country": "Germany",
            "subscription_end": "2026-10-01T12:00:00Z",
            "bandwidth_used": 12000,
            "status": "active",
            "created_at": "2019-08-24T14:15:22.123Z",
            "auto_renew": 0
        }
    ]
}
Modified at 2026-08-31 19:53:35
Previous
🔐 Authenticated
Next
Sync Subscription
Built with