Contents

GET [/instances/$INSTANCE]/private/accounts#

This is used to return the list of all the bank accounts of an instance.

Required permission: accounts-read

Response:

200 OK:

The backend has successfully returned all the accounts. Returns a AccountsSummaryResponse.

404 Not found:

The backend has does not know about the instance.

Details:

interface AccountsSummaryResponse {

  // List of accounts that are known for the instance.
  accounts: BankAccountEntry[];
}
interface BankAccountEntry {

  // Full payto:// URI of the account.
  payto_uri: string;

  // Hash over the wire details (including over the salt).
  h_wire: HashCode;

  // true if this account is active,
  // false if it is historic.
  active: boolean;
}