Skip to main content


Fetch one or more accounts by their ids.

⚠️ Note that you should not check an account's balance using this request before creating a transfer. That would not be atomic and the balance could change in between the check and the transfer. Instead, set the debits_must_not_exceed_credits or credits_must_not_exceed_debits flag on the accounts to limit their account balances. More complex conditional transfers can be expressed using balance-conditional transfers.


An id belonging to a Account.


  • If the account exists, return the Account.
  • If the account does not exist, return nothing.

Client libraries

For language-specific docs see:


If you're curious and want to learn more, you can find the source code for looking up an account in src/state_machine.zig. Search for fn execute_lookup_accounts(.