Skip to main content
GET
/
balances
/
{balance_id}
/
lineage
View balance lineage
curl --request GET \
  --url http://localhost:5001/balances/{balance_id}/lineage \
  --header 'X-blnk-key: <api-key>'
Use client.LedgerBalance.GetLineage to inspect a balance’s fund breakdown.
Fund lineage must be enabled on the balance when it was created. See Fund lineage.
1

Call the method

client.LedgerBalance.GetLineage
lineage, resp, err := client.LedgerBalance.GetLineage(
	"bln_5ce86029-3c2e-4e2a",
)
FieldTypeDescription
balanceIDstringBalance ID with fund lineage enabled.
2

Use the provider breakdown

Read lineage.Providers to see how much each provider contributed, spent, and has available. Use TotalWithLineage for the aggregate tracked amount.
3

Response

200 OK
{
  "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"
    }
  ]
}
FieldTypeDescription
balance_idstringBalance you queried.
aggregate_balance_idstringInternal aggregate balance ID for combined provider funds.
total_with_lineagestringTotal available funds tracked by lineage (minor units).
providersobject[]Provider-by-provider breakdown of received and spent funds.

Fund lineage

Tagged funds and allocation strategies.

View balance lineage

HTTP request and response schema.

​
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.