Ledger balances

View balance lineage

See a balance's provider breakdown when fund lineage is enabled with the Python SDK.

GET/balances/{balance_id}/lineage

Use blnk.ledger_balances.get_lineage to inspect a balance’s fund breakdown.

Call the method

response = blnk.ledger_balances.get_lineage(
  "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
)

Field	Type	Description
`balanceId`	`str`	Balance ID with fund lineage enabled.

Use the provider breakdown

Read response.data["providers"] to see how much each provider contributed, spent, and has available. Use total_with_lineage for the aggregate tracked amount.

Response

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

Field	Type	Description
`balance_id`	`str`	Balance you queried.
`aggregate_balance_id`	`str`	Internal aggregate balance ID for combined provider funds.
`total_with_lineage`	`str`	Total available funds tracked by lineage (minor units).
`providers`	`list[dict]`	Provider-by-provider breakdown of received and spent funds.