Renew an Existing VPN Subscription (Anonymous)

POST

https://tunnelsats.com/api/public/v1/subscription/renew

Generates a Lightning renewal invoice for an existing WireGuard public key on a target server. No authentication required. Rate limit: 20 requests/min per IP.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Renewal invoice generated

Bodyapplication/json

🟠400Bad Request

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/public/v1/subscription/renew' \
--header 'Accept;' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data '{
    "wgPublicKey": "pWyZTQx8C4gzzgMVJHiN1ptI46wDtyJSMRa+wxtkXOM=",
    "serverId": "eu-de",
    "duration": 1
}'

Response Example

200 - Success Example

{
    "invoice": "lnbc30000n1p...",
    "paymentHash": "b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3",
    "oldExpiry": "2026-09-15T12:00:00Z",
    "newExpiry": "2026-12-15T12:00:00Z",
    "renewalId": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
}

Modified at 2026-09-02 16:36:08

Get Subscription & Bandwidth Status by WireGuard Public Key

Sync Subscription (Real-Time Server Refresh)