Ledger balances

Historical balances

Retrieve accurate historical balance information with the Python SDK.

GET/balances/{balance_id}/at

Use blnk.ledger_balances.get_at to retrieve a balance at a specific point in time.

Call the method

response = blnk.ledger_balances.get_at(
  "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
  {
    "timestamp": "2025-02-24T08:55:26Z",
  },
)

Field	Type	Description
`balanceId`	`str`	Balance ID to query.
`timestamp`	`str`	Specifies the exact date and time for which a historical balance is requested. Use ISO 8601 format (for example `2025-02-24T08:55:26Z`).
`from_source`	`bool`	When `True`, reconstruct from transactions instead of snapshots.

Use the historical amounts

Read response.data["balance"] for net, credit, and debit totals at the requested timestamp. Compare with current balance if you are auditing or reconciling.

Response

{
  "timestamp": "2025-02-24T08:55:26Z",
  "from_source": false,
  "balance": {
    "balance_id": "bln_5ce86029-3c2e-4e2a-aae2-7fb931ca4c4f",
    "balance": 5000,
    "credit_balance": 5000,
    "debit_balance": 0,
    "currency": "USD"
  }
}

Field	Type	Description
`timestamp`	`str`	Point in time you queried (ISO 8601).
`from_source`	`bool`	Whether the balance was reconstructed from transactions.
`balance.balance_id`	`str`	Balance you queried.
`balance.balance`	`number`	Net amount at that timestamp.
`balance.credit_balance`	`number`	Total credits at that timestamp.
`balance.debit_balance`	`number`	Total debits at that timestamp.
`balance.currency`	`str`	Currency of the balance.