Check Invoice Status & Polling by Payment Hash

GET

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

Poll this endpoint after payment to check invoice settlement status. Returns subscription details once paid. Rate limit: 60 requests/min per IP.

Request

Path Params

Header Params

Responses

🟢200OK

application/json

Subscription/Invoice status

Bodyapplication/json

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success Example

{
    "status": "paid",
    "subscriptionEnd": "2026-10-15T12:00:00Z",
    "bandwidthUsed": 0,
    "server": {
        "id": "eu-de",
        "domain": "de2.tunnelsats.com",
        "endpoint": "de2.tunnelsats.com:51820"
    }
}

Modified at 2026-09-02 07:41:45

Create a New WireGuard Subscription (Invoice Generation)