# Retrieve List of Sub-Merchants Balance

## Method and URL

<mark style="color:green;">`POST`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/balances/sub-merchants

## Request

**Request Body**

```json
{
    "usecase": "DISBURSEMENT",
    "page": 1,
    "perPage": 5
}
```

**Detail Parameter Request**&#x20;

<table><thead><tr><th>Parameter</th><th width="115.6083984375">Data Type</th><th width="129.8974609375">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>usecase</td><td>String</td><td>M</td><td><p>Sub-merchant balance types are:</p><ul><li>DISBURSEMENT </li><li>PAYMENT</li></ul></td></tr><tr><td>page</td><td>Number</td><td>O</td><td></td></tr><tr><td>perPage</td><td>Number</td><td>O</td><td>Maximum 30 records per page, default is 30 records</td></tr></tbody></table>

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
    "code": "00",
    "message": "Success",
    "data": [
        {
            "merchantId": "535f73fc-cb40-4127-9fb4-4d32057451f8",
            "availableBalance": {
                "value": 0,
                "currency": "IDR"
            }
        },
        {
            "merchantId": "6f37946a-9ce5-42c7-a516-0dec7419dbcc",
            "availableBalance": {
                "value": 0,
                "currency": "IDR"
            }
        }
    ],
    "pagination": {
        "page": 1,
        "perPage": 2,
        "totalItems": 65,
        "totalPages": 33
    }
}
```

{% endcode %}

**Detail Parameter Response**&#x20;

<table><thead><tr><th>Parameter</th><th width="127.20404052734375">Data Type</th><th width="133.248291015625">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>merchantId</td><td>String</td><td>M</td><td>Your Sub-merchant ID</td></tr><tr><td>availableBalance</td><td>Object</td><td>M</td><td>Available balance for the Sub-merchant</td></tr><tr><td><ul><li>value</li></ul></td><td>Number</td><td>M</td><td>Amount Value</td></tr><tr><td><ul><li>currency</li></ul></td><td>String</td><td>M</td><td>Currency code in ISO 4217 Format, e.g. USD, IDR</td></tr></tbody></table>
