List Account Subscriptions (Authenticated)

GET

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

Returns all subscriptions linked to your authenticated account. Note: response uses snake_case keys (e.g. payment_hash, subscription_end). Rate limit: 30 requests/min per account.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Responses

🟢200

application/json

List of active subscriptions

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/public/v1/subscription/list' \
--header 'Accept;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "subscriptions": [
        {
            "payment_hash": "a1b2c3d4e5f6...",
            "server_domain": "de2.tunnelsats.com",
            "subscription_end": "2026-10-15T12:00:00Z",
            "status": "paid",
            "bandwidth_used_gb": 12.5
        }
    ]
}

Modified at 2026-10-10 22:07:24

Request Bandwidth Top-Up ($1 Usage Reset)

Create Referral Code