1. πŸ“‘ Discovery
TunnelSats Public Wireguard API
  • Announcements
    • πŸ‘‹ About our team
    • πŸ’« What is TunnelSats?
    • πŸš€ Introducing the TunnelSats Public API v1
    • How TunnelSats Leverages Public APIs for Confined VPN Management
  • πŸ“‘ Discovery
    • List Available WireGuard Servers & Regions
      GET
  • ⚑ Purchase
    • Create a New WireGuard Subscription (Invoice Generation)
      POST
    • Check Invoice Status & Polling by Payment Hash
      GET
    • Claim WireGuard Configuration After Payment Settlement
      POST
  • πŸ”„ Lifecycle
    • Get Subscription & Bandwidth Status by WireGuard Public Key
      POST
    • Renew an Existing VPN Subscription (Anonymous)
      POST
    • Sync Subscription (Real-Time Server Refresh)
      POST
    • Request Bandwidth Top-Up ($1 for +100GB)
      POST
  • πŸ”‘ Account
    • List Account Subscriptions (Authenticated)
      GET
  • πŸ”§ Tools
    • Lightning Node Network Address Discovery
      POST
    • Universal Connectivity & Latency Probe
      POST
  • Cookbook
    • πŸ› οΈ Automation & Code Examples
    • 🐚 Bash One-Liners
    • πŸš‘ Node Health & Upkeep
    • ⚑ Bandwidth Top-Up ($1 for +100GB)
    • πŸ›‘οΈ Security & Authentication
    • 🎁 Referral Program: Earn Bonus Months
    • πŸ›‘ Error Codes & Troubleshooting
  • Schemas
    • Server
    • InvoiceOrder
    • SubscriptionStatus
    • NodeLookup
    • ConnectivityResult
    • ApiError
    • ClaimResult
    • BandwidthResetResponse
    • PublicKeyStatusResponse
    • RenewalOrder
    • SubscriptionListItem
    • SyncResult
Tunnelsats Github
Tunnelsats Telegram
  1. πŸ“‘ Discovery

List Available WireGuard Servers & Regions

GET
https://tunnelsats.com/api/public/v1/servers
Returns all active TunnelSats servers with real-time operational status and geographic metadata. Rate limit: 60 requests/min per IP.

Request

Header Params

Responses

🟒200OK
application/json
List of available servers
Bodyapplication/json

🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://tunnelsats.com/api/public/v1/servers' \
--header 'Accept;'
Response Response Example
200 - Success Example
{
    "servers": [
        {
            "id": "eu-de",
            "country": "Germany",
            "city": "Nuremberg",
            "flag": "πŸ‡©πŸ‡ͺ",
            "status": "online"
        },
        {
            "id": "us-east",
            "country": "USA",
            "city": "Ashburn",
            "flag": "πŸ‡ΊπŸ‡Έ",
            "status": "online"
        },
        {
            "id": "us-west",
            "country": "USA",
            "city": "Hillsboro",
            "flag": "πŸ‡ΊπŸ‡Έ",
            "status": "online"
        },
        {
            "id": "asia-sg",
            "country": "Singapore",
            "city": "Singapore",
            "flag": "πŸ‡ΈπŸ‡¬",
            "status": "online"
        },
        {
            "id": "sa-br",
            "country": "Brazil",
            "city": "Sao Paulo",
            "flag": "πŸ‡§πŸ‡·",
            "status": "online"
        },
        {
            "id": "oc-au",
            "country": "Australia",
            "city": "Sydney",
            "flag": "πŸ‡¦πŸ‡Ί",
            "status": "online"
        }
    ]
}
Modified atΒ 2026-09-02 16:36:08
Previous
How TunnelSats Leverages Public APIs for Confined VPN Management
Next
Create a New WireGuard Subscription (Invoice Generation)
Built with