Check Region Switch Eligibility

POST

https://tunnelsats.com/api/public/v1/subscription/migrate/check

Locate the current key across offered gateways (and test gateways only when enabled). serverId optionally selects the source gateway ID. Requires strictly more than 24 hours remaining. Returns shared 2/UTC-month quota and 72-hour/2000 MB grace rules. Eligible sources receive a durable ten-minute X25519 challenge. Quota-exhausted sources may also receive a challenge to recover an exact existing unpaid invoice; the challenge reserves no slot. Expired invoices release quota only after authoritative unpaid confirmation. Rate limit: 10 requests/min per IP (rolling window). Request bodies are limited to 8192 bytes.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Advisory eligibility, quota, and optional ownership challenge.

Headers

Bodyapplication/json

🟠400

🟠403

🟠404

🟠409

🟠413

🟠429

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://tunnelsats.com/api/public/v1/subscription/migrate/check' \
--header 'Content-Type: application/json' \
--data '{
    "wgPublicKey": "hSDwCYkwp1R0i33ctD73Wg2/Og0mOBr066SpjqqbTmo=",
    "serverId": "eu-de"
}'

Response Example

200 - Success Example

{
    "eligible": true,
    "reason": null,
    "currentServer": {
        "id": "eu-de",
        "domain": "de2.tunnelsats.com",
        "country": "Germany",
        "city": "Nuremberg",
        "flag": "🇩🇪"
    },
    "subscriptionEnd": "2027-03-01T12:34:56.000Z",
    "resetsThisMonth": 0,
    "maxResetsPerMonth": 2,
    "remainingSlots": 2,
    "grace": {
        "maxHours": 72,
        "additionalMb": 2000,
        "cappedAtSourceAllowance": true,
        "unlimited": false
    },
    "challengePubKey": "V4TFx8LMrIYdUKJeXVi7/H5CYHrWE1UlX6WTxD063wY=",
    "challengeWindow": 123,
    "challengeExpiresAt": "2026-11-02T12:10:00.000Z"
}

Modified at 2026-11-06 19:55:30

Request Bandwidth Top-Up ($1 Usage Reset)

Create or Reuse Region Switch Invoice