> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Balance Reconstruction
> Reconstruct and correct discrepancies in your ledger balances.
export const CtaCallout = props => {
const {title, buttonLabel, href, trackingEvent, buttonTarget, rel = "noopener noreferrer", children} = props;
const handleCtaClick = () => {
if (typeof window === "undefined" || !trackingEvent) {
return;
}
try {
window.dispatchEvent(new CustomEvent("blnk:docs-cta", {
detail: {
name: trackingEvent,
href
}
}));
} catch {}
try {
window.posthog?.capture?.(trackingEvent, {
href
});
} catch {}
const gaPayload = {
cta_href: href
};
try {
window.gtag?.("event", trackingEvent, gaPayload);
} catch {}
try {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
event: trackingEvent,
...gaPayload
});
} catch {}
};
const isExternal = typeof href === "string" && (/^https?:\/\//i).test(href);
const target = buttonTarget ?? (isExternal ? "_blank" : undefined);
const linkRel = isExternal ? rel : undefined;
return ;
};
Available on version 0.10.1 or later.
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, call the [Update Metadata](/reference/update-metadata) endpoint with the balance ID and set `BLNK_RUN_RECONCILIATION` to `SOURCE`:
```bash cURL wrap theme={"system"}
curl -X POST "http://YOUR_BLNK_INSTANCE_URL/{balance_id}/metadata" \
-H "X-blnk-key: " \
-H "Content-Type: application/json" \
-d '{
"meta_data": {
"BLNK_RUN_RECONCILIATION": "SOURCE"
}
}'
```
```typescript TypeScript wrap theme={"system"}
const response = await blnk.Metadata.update(
'bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f',
{
meta_data: {
BLNK_RUN_RECONCILIATION: 'SOURCE',
},
},
);
```
```go Go wrap theme={"system"}
meta, resp, err := client.Metadata.UpdateMetadata(
"bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
blnkgo.UpdateMetaDataRequest{
MetaData: map[string]interface{}{
"BLNK_RUN_RECONCILIATION": "SOURCE",
},
},
)
```
```json Response theme={"system"}
{
"meta_data": {
"BLNK_RUN_RECONCILIATION": "SOURCE"
}
}
```
***
## Verifying the results
To check the results, retrieve the balance details with the [Get Balance](/reference/get-balance) endpoint:
```bash cURL wrap theme={"system"}
curl -X GET "http://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}" \
-H "X-blnk-key: "
```
```typescript TypeScript wrap theme={"system"}
const response = await blnk.LedgerBalances.get(
'bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f',
);
```
```go Go wrap theme={"system"}
balance, resp, err := client.LedgerBalance.Get("bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f")
```
The results will be available in the `meta_data` object:
```json Response theme={"system"}
{
"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"
}
}
}
```
| Field | Description |
| :--------------------- | :------------------------------------------------------------------------- |
| `difference` | The discrepancy between the previous balance and the recalculated balance. |
| `executed_at` | The timestamp when the reconstruction was performed. |
| `previous_balance` | The balance recorded before reconstruction. |
| `previous_credit` | The total credit amount recorded before reconstruction. |
| `previous_debit` | The total debit amount recorded before reconstruction. |
| `recalculated_balance` | The corrected balance after reconstruction. |
| `recalculated_credit` | The total credit amount after recalculating from transactions. |
| `recalculated_debit` | The 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](mailto:support@blnkfinance.com) or [join our Discord community](https://discord.gg/7WNv94zPpx).
Sign up and manage your ledger with our back-office dashboard. You can invite teammates to collaborate and manage your ledger operations directly from the dashboard.