GET
/
balances
/
{balance_id}
/
at
Historical Balances
curl --request GET \
  --url http://localhost:5001/balances/{balance_id}/at \
  --header 'X-blnk-key: <api-key>'

​
Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>.

Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code.

See also: Secure your Blnk server

​
Body

​
balance_id
string

Specifies the unique ID of the balance being retrieved.

​
timestamp
string
required

Specifies the exact date and time for which a historical balance is requested

GET http://YOUR_BLNK_INSTANCE_URL/balances/{balance_id}/at?timestamp=2025-02-24T08:55:26Z

Always format the date input as ‘YYYY-MM-DDTHH:MM:SS+00:00’ (e.g., 2024-04-22T15:28:03+00:00), where +00:00 specifies the timezone. It is UTC by default.

​
from_source
boolean

When set to true, it indicates that the balance should be reconstructed directly from its transactions, bypassing balance snapshots.

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