Sync Subscription (Real-Time Server Refresh)

POST

https://tunnelsats.com/api/public/v1/subscription/{paymentHash}/sync

Triggers a real-time sync from the VPN server to refresh bandwidth, expiry, and peer status. Requires authentication and subscription ownership. Rate limit: 5 requests/min per subscription.

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Subscription synced successfully

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://tunnelsats.com/api/public/v1/subscription//sync' \
--header 'Authorization;' \
--header 'Accept;'

Response Example

200 - Success Example

{
    "success": true,
    "subscription": {
        "expiry": "2026-10-15T12:00:00Z",
        "bandwidth_used_gb": 45.67,
        "status": "enabled",
        "server_domain": "de2.tunnelsats.com"
    }
}

Modified at 2026-09-02 16:25:43

Renew an Existing VPN Subscription (Anonymous)

Request Bandwidth Top-Up ($1 for +100GB)