Get Subscription & Bandwidth Status by WireGuard Public Key

POST

/api/public/v1/subscription/status

Polls WireGuard servers to return real-time expiry, bandwidth consumption in GB, peer enable status, and hosting server domain for a given WireGuard public key.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Status retrieved successfully

Bodyapplication/json

🟠400Bad Request

🟠404Record Not Found

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/public/v1/subscription/status' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data '{
    "wgPublicKey": "pWyZTQx8C4gzzgMVJHiN1ptI46wDtyJSMRa+wxtkXOM="
}'

Response Example

200 - Example 1

{
    "expiry": "2026-10-15T12:00:00Z",
    "bandwidth_used_gb": 85.4,
    "status": "enabled",
    "server_domain": "us3.tunnelsats.com",
    "last_synced_at": "2026-08-31T18:00:00Z"
}

Modified at 2026-08-31 19:53:35

Renew an Existing VPN Subscription (Anonymous)

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