summaryrefslogtreecommitdiff
path: root/core/api-bank-access.rst
diff options
context:
space:
mode:
Diffstat (limited to 'core/api-bank-access.rst')
-rw-r--r--core/api-bank-access.rst23
1 files changed, 23 insertions, 0 deletions
diff --git a/core/api-bank-access.rst b/core/api-bank-access.rst
index c1c39feb..3795387f 100644
--- a/core/api-bank-access.rst
+++ b/core/api-bank-access.rst
@@ -30,6 +30,29 @@ to enabling wallets to withdraw with a better user experience ("tight integratio
Accounts and Withdrawals
------------------------
+.. http:get:: ${BANK_API_BASE_URL}/public-accounts
+
+ Show those accounts whose histories are publicly visible. For example,
+ accounts from donation receivers. As such, this request is unauthenticated.
+
+ **Response**
+
+ **Details**
+
+ .. ts:def:: PublicAccountsResponse
+
+ interface PublicAccountsResponse {
+ publicAccounts: PublicAccount[]
+ }
+
+ interface PublicAccount {
+ iban: string;
+ balance: string;
+ // The account name _and_ the username of the
+ // Sandbox customer that owns such a bank account.
+ accountLabel: string;
+ }
+
The following endpoints require HTTP "Basic" authentication with the account
name and account password, at least in the GNU Taler demo bank implementation.