Explore Your Accounts
List accounts and retrieve balances.
List your accounts
After connecting the Testbank, your sandbox organization will have several accounts. Use the accounts endpoint to list them and find the account IDs you will need for payments.
/financial-data/v2/accountsList all accounts in your organization. Returns IDs, currency, name, identifiers (IBAN/BBAN), and routing (BIC).
curl 'https://api.atlar.com/financial-data/v2/accounts?limit=10' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'Retrieve balances
For any account, you can retrieve the most recent balance snapshot. The mostRecent=true parameter returns only the latest balance entry per type.
/financial-data/v2/accounts/{id}/balancesGet balance snapshots for an account. Use mostRecent=true for the latest balance.
curl 'https://api.atlar.com/financial-data/v2/accounts/{{accountId}}/balances?mostRecent=true&limit=100' \
-H 'Authorization: Bearer ACCESS_TOKEN' \
-H 'Accept: application/json'Dashboard: Accounts
View all your bank accounts, their currencies, balances, and connected banks under the Accounts section.
Dashboard: Account Balances
Click into any account and select the Balances tab to see historical and current balance data.
Amount representation
Atlar represents monetary amounts as integers in the smallest currency unit (e.g. cents for EUR). A value of 125000 in EUR means EUR 1,250.00. The stringValue field provides the human-readable representation.
Pagination
All list endpoints support pagination via limit (1-500, default 100) and token. The response includes nextToken â if it is non-empty, more pages exist.
# Paginate through all accounts
all_accounts = []
token = ""
while True:
params = {"limit": 100}
if token:
params["token"] = token
resp = session.get(ACCOUNTS_URL, params=params)
data = resp.json()
all_accounts.extend(data["items"])
if not data["nextToken"]:
break
token = data["nextToken"]
print(f"Total accounts: {len(all_accounts)}")Pagination pitfall
Never compare the length of items to limit to determine if more pages exist. There may be fewer items than the limit even when more data is available. Always check nextToken.