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

This is used to obtain detailed information about a specific bank account.

Required permission: accounts-read

Response:

200 OK:

The backend has successfully returned the detailed information about a specific bank account. Returns a BankAccountDetail.

404 Not found:

The bank account or instance is unknown to the backend.

Details:

interface BankAccountDetail {

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

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

  // Salt used to compute h_wire.
  salt: HashCode;

  // URL from where the merchant can download information
  // about incoming wire transfers to this account.
  credit_facade_url?: string;

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

  // Additional text to include in the wire transfer subject when
  // settling the payment. Note that the merchant MUST use this
  // consistently for the same merchant_pub and merchant_payto_uri
  // as during aggregation *any* of these values may be selected
  // for the actual aggregated wire transfer. If a merchant wants
  // to use different extra_subject values for the same IBAN,
  // it should thus create multiple instances (with different
  // merchant_pub values). When changing the extra_subject,
  // the change may thus not be immediately reflected in the
  // settlements.
  //
  // Must match [a-zA-Z0-9-.:]{1, 40}
  //
  // Optional. Since **v27**.
  extra_wire_subject_metadata?: string;
}