> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mioesim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api_esim/getBalance — Get account balance

> Retrieve your current MIOeSIM account balance and currency. Orders are automatically deducted from this pre-funded balance when placed via the API.

MIOeSIM uses a pre-funded account model — you top up your balance and orders are deducted from it. Use this endpoint to check your current available balance before placing orders.

```
GET https://bpm.mioesim.com/api_esim/getBalance
```

## Request parameters

<ParamField query="token" type="string" required>Session token.</ParamField>
<ParamField query="sign" type="string" required>Request signature.</ParamField>

## Response fields

<ResponseField name="data" type="object">
  <Expandable title="fields">
    <ResponseField name="balance" type="string">Current account balance (e.g. `"628.49"`).</ResponseField>
    <ResponseField name="currency" type="string">Currency code (e.g. `"USD"`).</ResponseField>
  </Expandable>
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://bpm.mioesim.com/api_esim/getBalance?token=YOUR_TOKEN&sign=YOUR_SIGN"
  ```

  ```json Success theme={null}
  {
    "code": "0",
    "message": "success",
    "data": {
      "balance": "628.49",
      "currency": "USD"
    }
  }
  ```

  ```json Error - Token expired theme={null}
  { "code": -1, "message": "token expire", "data": "" }
  ```
</CodeGroup>

<Tip>
  Check your balance before placing bulk orders to avoid failures due to insufficient funds.
</Tip>