Available on version 0.10.1 or later.

​
Overview

Balance Reconstruction helps you solve situations where your balances go out of sync and you have to rebuild the balance from the ground up. It does this by recalculating a balance from its transactions to ensure it correctly reflects all recorded activity.

​
Reconstructing a balance

To reconstruct a balance, update its metadata with the following request: 
POST https://YOUR_BLNK_INSTANCE_URL/{balance_id}/metadata

{
  "meta_data": {
    "BLNK_RUN_RECONCILIATION": "SOURCE"
  }
}

​
Verifying the results

To check the results, retrieve the balance details with the Get Balance endpoint: 
GET https://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}
The results will be available in the meta_data object:
Response
{
  "meta_data": {
    "BLNK_RECONCILIATION_RESULT": {
      "difference": "103842",
      "executed_at": "2025-03-16 22:55:34.281624+00",
      "previous_balance": "600",
      "previous_credit": "1200",
      "previous_debit": "600",
      "recalculated_balance": "104442",
      "recalculated_credit": "119600",
      "recalculated_debit": "15158"
    }
  }
}
FieldDescription
differenceThe discrepancy between the previous balance and the recalculated balance.
executed_atThe timestamp when the reconstruction was performed.
previous_balanceThe balance recorded before reconstruction.
previous_creditThe total credit amount recorded before reconstruction.
previous_debitThe total debit amount recorded before reconstruction.
recalculated_balanceThe corrected balance after reconstruction.
recalculated_creditThe total credit amount after recalculating from transactions.
recalculated_debitThe total debit amount after recalculating from transactions.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.