Organisation Balance

eSIM Go operates on a pre-paid model. Your organisation balance is deducted each time you place an order. This guide explains how to monitor your balance, top it up through the portal, and set up automatic top-ups to avoid service interruptions.

Checking your balance

Your current balance is returned as part of your organisation details:

curl https://api.esim-go.com/v2.5/organisation \
  -H 'X-API-Key: $API_KEY'

The response includes balance (your total balance including any test credit), testCredit (the portion that is test credit), and currency.

{
  "balance": 10000,
  "testCredit": 500,
  "currency": "USD"
}

Note

Test credit is included in the balance total. To find your real spendable balance: balance - testCredit.

Topping up

Top-ups are managed through the portal at Billing → Top Up.

The page shows your current balance, daily spend, and auto top-up status at a glance. To add funds, enter an amount (or choose a preset) and complete the card payment. The minimum and maximum top-up amounts are shown on the page and vary by account.

Your card details are saved after your first successful payment, so future top-ups only require entering an amount.

Auto top-up

Auto top-up automatically charges your saved card when your balance falls below a threshold you define. To configure it, go to Billing → Top Up and click Enable on the Auto Top-up card.

You can set:

• Threshold — the balance level that triggers a top-up
• Amount — how much to charge when the threshold is hit

Note

If 5 consecutive auto top-ups fail, auto top-up will be disabled automatically and you will be notified.

Balance notifications

To receive alerts when your balance is running low, enable Balance Alerts in Settings → Notifications. This sends a notification when your balance dips below the threshold configured in your auto top-up settings.

You can also receive real-time webhook callbacks for balance events — see the BalanceThreshold event in the Notifications API reference.