Retrieve Balance History

Access a record of past balance changes over time

Method and URL

GET [BASE_URL]/v1/balance-histories?startDate={startDate}&endDate={endDate}&accountType={balanceType}

Query Parameter

Detail Query Parameter

Parameter	Data Type	Requirement	Description
startDate	String	M	Filter start date (ISO 8601 format) : Max Back Date = 6 Months Max Range = 31 Days
endDate	String	M	Filter end date (ISO 8601 format) Max Back Date = 6 Months Max Range = 31 Days
accountType	String	O	List of Account Types

Response

Response Body

{
  "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
  }
}

Detail Parameter Response

Parameter	Data Type	Requirement	Description
data	Array of Objects	O	Object consisting of Merchant’s balance history
referenceId	String	M	Same data as in Merchant Dashboard - Balance History
date	String	M	Transaction date
settlementDate	String	O	Same data as in Merchant Dashboard - Balance History
settlementStatus	String	M	Same data as in Merchant Dashboard - Balance History
balanceType	String	M	Same data as in Merchant Dashboard - Balance History
channel	String	O	Same data as in Merchant Dashboard - Balance History
transactionType	String	M	Same data as in Merchant Dashboard - Balance History
amount	Object	O	Same data as in Merchant Dashboard - Balance History
value	Float	M	The amount value
currency	String	M	The amount currency
fee	Object	O	Same data as in Merchant Dashboard - Balance History
value	Float	M	The amount value
currency	String	M	The amount currency
createdBy	String	M	Same data as in Merchant Dashboard - Balance History
transactionId	String	M	Same data as in Merchant Dashboard - Balance History
pagination	Object	M	Pagination

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