> For the complete documentation index, see [llms.txt](https://docs.sms4sats.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sms4sats.com/api-reference/get-balance.md).

# Get Balance

<mark style="color:blue;">`GET`</mark> `https://api2.sms4sats.com/balance`

Returns the current satoshi balance for a prepaid API Key.

#### Headers

| Name        | Type   | Required | Description   |
| ----------- | ------ | -------- | ------------- |
| `X-API-Key` | String | Yes      | Your API Key. |

{% tabs %}
{% tab title="200: OK" %}
{% code overflow="wrap" %}

```javascript
{
    status: 'OK', 
    balance: 10000
}
```

{% endcode %}
{% endtab %}

{% tab title="400: Bad Request" %}

```javascript
{
    status: 'error',
    reason: 'X-API-Key header is missing.'
}
```

{% endtab %}
{% endtabs %}

### Response Fields

| Field     | Type   | Description                 |
| --------- | ------ | --------------------------- |
| `status`  | String | `OK` on success             |
| `balance` | Number | Current balance in satoshis |

{% hint style="info" %}
Use [Fund Account](/api-reference/fund-account.md) to top up your balance, and [Get History](/api-reference/get-history.md) to review past funding transactions.
{% endhint %}