# Retrieve Balance History

## Method and URL

<mark style="color:green;">`GET`</mark> \[<mark style="color:orange;">BASE\_URL</mark>]/v1/balance-histories?startDate={startDate}\&endDate={endDate}

## Query Parameter

**Detail Query Parameter**

<table><thead><tr><th>Parameter</th><th width="114.62109375">Data Type</th><th width="122.45703125">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>startDate</td><td>String</td><td>M</td><td><p></p><p>Filter start date (ISO 8601 format) :</p><ul><li>Max Back Date = 6 Months</li><li>Max Range = 31 Days</li></ul></td></tr><tr><td>endDate</td><td>String </td><td>M</td><td><p></p><p>Filter end date (ISO 8601 format)</p><ul><li>Max Back Date = 6 Months</li><li>Max Range = 31 Days</li></ul></td></tr><tr><td>accountType</td><td>String</td><td>O</td><td><a data-mention href="#list-of-account-types">#list-of-account-types</a></td></tr><tr><td>transactionId</td><td>String</td><td>O</td><td>Reference ID of your transaction</td></tr></tbody></table>

## Response

**Response Body**

{% code fullWidth="false" %}

```json
{
  "code": "00",
  "message": "Success",
  "data": [
    {
      "referenceId": "1748603636",
      "date": "2025-05-30T11:14:24.352687Z",
      "settlementDate": "2025-05-30T11:14:24Z",
      "settlementStatus": "SUCCESS",
      "balanceType": "Payment Balance",
      "channel": "Virtual Account",
      "transactionType": "VA Payment",
      "amount": {
        "value": 10000,
        "currency": "IDR"
      },
      "fee": {
        "value": 4000,
        "currency": "IDR"
      },
      "createdBy": "Reforza Pivot",
      "transactionId": "e89e6584-d25d-4ccf-ac50-a95369fe2ae0"
    }
  ],
  "pagination": {
    "page": 1,
    "perPage": 1,
    "totalItems": 89,
    "totalPages": 89
  }
}
```

{% endcode %}

**Detail Parameter Response**&#x20;

<table><thead><tr><th>Parameter</th><th width="123.53125">Data Type</th><th width="131.44921875">Requirement</th><th>Description</th></tr></thead><tbody><tr><td>data</td><td>Array of Objects</td><td>O</td><td>Object consisting of Merchant’s balance history</td></tr><tr><td><ul><li>referenceId</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>date</li></ul></td><td>String</td><td>M</td><td>Transaction date</td></tr><tr><td><ul><li>settlementDate</li></ul></td><td>String</td><td>O</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>settlementStatus</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>balanceType</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>channel</li></ul></td><td>String</td><td>O</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>transactionType</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>amount</li></ul></td><td> Object</td><td>O</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><blockquote><ul><li>value</li></ul></blockquote></td><td>Float</td><td>M</td><td>The amount value</td></tr><tr><td><blockquote><ul><li>currency</li></ul></blockquote></td><td>String</td><td>M</td><td>The amount currency</td></tr><tr><td><ul><li>fee</li></ul></td><td>Object</td><td>O</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><blockquote><ul><li> value</li></ul></blockquote></td><td>Float</td><td>M</td><td>The amount value</td></tr><tr><td><blockquote><ul><li>currency</li></ul></blockquote></td><td>String</td><td>M</td><td>The amount currency</td></tr><tr><td><ul><li>createdBy</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td><ul><li>transactionId</li></ul></td><td>String</td><td>M</td><td>Same data as in Merchant Dashboard - Balance History</td></tr><tr><td>pagination</td><td>Object</td><td>M</td><td><a data-mention href="../../../api-information/pagination">pagination</a></td></tr></tbody></table>

## List of Account Types

| Balance Type | Transaction Type           |
| ------------ | -------------------------- |
| PAYMENT      | BALANCE\_ADJUSTMENT        |
| PAYMENT      | TRANSFER                   |
| PAYMENT      | PAYMENT\_WITHDRAWAL        |
| PAYMENT      | CARD\_PAYMENT              |
| PAYMENT      | VA\_PAYMENT                |
| PAYMENT      | QRIS\_PAYMENT              |
| PAYMENT      | PLATFORM\_TRANSACTION\_FEE |
| PAYMENT      | REFUND                     |
| PAYMENT      | REFUND\_FEE                |
| PAYMENT      | PAYMENT\_FEE               |
| DISBURSEMENT | VA\_TOP\_UP                |
| DISBURSEMENT | MANUAL\_TOP\_UP            |
| DISBURSEMENT | BALANCE\_ADJUSTMENT        |
| DISBURSEMENT | TRANSFER                   |
| DISBURSEMENT | DISBURSEMENT\_WITHDRAWAL   |
| DISBURSEMENT | DISBURSEMENT               |
| DISBURSEMENT | BULK\_DISBURSEMENT         |
| DISBURSEMENT | ACCOUNT\_INQUIRY\_FEE      |
| DISBURSEMENT | INTERNATIONAL\_PAYOUT      |
| DISBURSEMENT | PLATFORM\_ACTIVITY\_FEE    |
| DISBURSEMENT | PLATFORM\_TRANSACTION\_FEE |
| DISBURSEMENT | DISBURSEMENT\_FEE          |
| WALLET       | VA\_TOP\_UP                |
| WALLET       | MANUAL\_TOP\_UP            |
| WALLET       | BALANCE\_ADJUSTMENT        |
| WALLET       | WALLET\_WITHDRAWAL         |
| WALLET       | MERCHANT\_PAYMENT          |
| WALLET       | FEE\_TOP\_UP               |
| WALLET       | FEE\_BANK\_TRANSFER        |
| WALLET       | FEE\_WALLET\_TRANSACTION   |
| WALLET       | FEE\_TRANSFER              |