> For the complete documentation index, see [llms.txt](https://docs.betaramps.com/documentation-beta-ramps/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.betaramps.com/documentation-beta-ramps/request-payments/merchants-account-balance.md).

# Merchant's Account Balance

## Retrieve the balance of an specific asset for a specific account or subaccount

<mark style="color:blue;">`GET`</mark> `https://live.betaapp.com/v1/balance`

#### Query Parameters

| Name                                    | Type   | Description                                    |
| --------------------------------------- | ------ | ---------------------------------------------- |
| asset<mark style="color:red;">\*</mark> | String | Fiat Asset used on your settlement preference. |

#### Headers

| Name                                            | Type   | Description                             |
| ----------------------------------------------- | ------ | --------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer {access\_token}                  |
| x-sub-account-id                                | String | ID of your subaccount, If you have one. |
| accept<mark style="color:red;">\*</mark>        | String | application/json                        |

{% tabs %}
{% tab title="200: OK Sucess" %}

```json
{
  "message": "string",
  "number_of_orders_associated": 0,
  "total_asset": "string",
  "total_amount": 0,
  "total_fees": 0
}
```

{% endtab %}

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

```json
{
  "message": "string"
}
```

{% endtab %}
{% endtabs %}

**Request Example:**

{% code overflow="wrap" %}

```json
curl -X 'GET' \
  'https://live.betaapp.com/v1/balance?asset=BRL' \
  -H 'accept: application/json' \
  -H 'X-sub-account-id: 22376b76...3543083b' \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InJlaEF1NURPY...ctfx2I4g'
```

{% endcode %}

**Response Example:**

```json
{
  "total_amount": 18500,
  "total_fees": 185,
  "number_of_orders_associated": 22
}
```

{% hint style="info" %}
The `total_fees` parameter represents the amount in fees that will be discounted during the settlement process.
{% endhint %}

{% hint style="success" %}
The `number_of_orders_associated` parameter represents how many orders compose the `total_amount`.
{% endhint %}

### Settlements

Merchants are required to request settlements through the Dashboard. It could be requested automatically based on your [initial settings setup](/documentation-beta-ramps/getting-started/set-up-your-account.md), or it could be requested manually when you follow these steps:

1. **Click on the three dots on the right side of your balance amount**

You will be redirected to the Settlement History page, where you can see an overview of the amount ready for settlement.

![Balance in fiat being displayed on the Dashboard](/files/Tds5KiPaaNGlZHtiYZDN)

2. **Click on More Info located on the top-right side of the Settlement Overview**

<figure><img src="/files/ieFHVIEgbEsidtDZnxLs" alt="Beta&#x27;s Settlement Menu on Dashboard"><figcaption><p>Settlement Menu on Dashboard</p></figcaption></figure>

3. **Request your Settlement**

<figure><img src="/files/q5GwFSGUzw5MWHlsddKL" alt="Request Settlement Page"><figcaption><p>Request Settlement</p></figcaption></figure>