Balance Reconciliation

​

Overview

Balance Reconciliation verifies accuracy by recalculating a balance from its transactions to ensure it correctly reflects all recorded activity. It also ensures that the ledger remains a reliable source of truth by identifying and correcting discrepancies.

Unlike Historical Balances, which only computes and displays balances, Balance Reconciliation also applies corrections directly to your ledger when discrepancies are found, such as when the balance has been modified without authorization.

​

Running a balance reconciliation

To reconcile 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 reconciliation results, retrieve the balance details with the Get Balance endpoint:

GET https://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}

The reconciliation results will be available in the meta_data object:

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

​

Key considerations

1. If the difference is zero, the balance was already accurate.
2. If the difference is non-zero, the ledger has been updated to reflect the corrected balance.

​

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.

Love building with Blnk? We’d love to hear your feedback. Tell us here.