Retrieve Balance History
Access a record of past balance changes over time.
GET
[BASE_URL]/v1/balance-histories?startDate={startDate}&endDate={endDate}&accountType={balanceType}
Query Parameter
Detail Query Parameter
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
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
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
List of Account Types
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
Last updated