From cba3d9666c9cf50e574370da6f6d79def1c013bc Mon Sep 17 00:00:00 2001
From: ms <ms@taler.net>
Date: Wed, 12 Jan 2022 19:03:03 +0100
Subject: Sandbox Access API

---
 core/api-bank-access.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

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.
 
-- 
cgit v1.2.3