# Get Current Wallet Balance

The Wallet API allows you to monitor your account balance, track transactions, and enable or disable automatic top-ups. These endpoints help you manage funds used for sending SMS messages.

Retrieve the current balance of your account.

### <mark style="color:green;">`GET`</mark> `/wallet`

#### Required Permission

```
read:UserWallet
```

Your API key must have this permission enabled in order to use this endpoint.

#### Example Request

```bash
curl --location 'https://<hostname>/wallet' \
  --header 'Authorization: Bearer YOUR_API_KEY'
```

Replace `YOUR_API_KEY` with your API key.

{% hint style="info" %}
All endpoints shown in this documentation use a **sample base URL**. The production API endpoint is provided by our team upon request.
{% endhint %}

#### Response (HTTP 200)

```json
{
  "success": true,
  "balance": 42.50,
  "currency": "USD"
}
```