> ## 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.
# View balance lineage
> See a balance’s provider breakdown (received, spent, available) when fund lineage is enabled.
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 ;
};
If you're using the auto-provisioned `Enterprise Core` instance included with your Production License deployment, set the base URL to: `https://ENTERPRISE_PUBLIC_URL/core`.
If you're connecting to a different Core instance, use the publicly accessible base URL for that instance instead.
### Authorization
If set, the API uses an API key for authentication. Include the following header in your requests: `X-blnk-key: `.
Replace `` with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.
See also: [Scoped API keys](/api-keys/overview) and [Secure your Blnk server](/advanced/secure-blnk).
### Path
Specifies the unique ID of the balance whose lineage you want to retrieve.
### Response
The ID of the balance being queried.
The internal aggregate balance ID used to track combined provider funds.
Total available funds tracked by lineage (in minor units, like `precise_amount`).
Provider-by-provider breakdown of received and spent funds.
All amounts are returned as **strings** in **minor units**.
```bash theme={"system"}
curl -X GET "http://localhost:5001/balances/{balance_id}/lineage" \
-H "X-blnk-key: "
```
```json 200 theme={"system"}
{
"balance_id": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
"aggregate_balance_id": "bln_aggregate_shadow_balance_id",
"total_with_lineage": "7500",
"providers": [
{
"provider": "stripe",
"amount": "10000",
"available": "7500",
"spent": "2500",
"shadow_balance_id": "bln_shadow_balance_id"
}
]
}
```
```json 404 theme={"system"}
{
"error": "Balance with ID 'bln_a3f8c2e1-9d4b-4f7a-b6e2-1c8d5f0a7b3e' not found",
"error_detail": {
"code": "BAL_NOT_FOUND",
"message": "Balance with ID 'bln_a3f8c2e1-9d4b-4f7a-b6e2-1c8d5f0a7b3e' not found"
}
}
```
## 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.