more on Sandbox payments API

1 files changed, 19 insertions, 2 deletions

diff --git a/libeufin/api-sandbox.rst b/libeufin/api-sandbox.rst
index a410b9ee..6f1d152f 100644
--- a/libeufin/api-sandbox.rst
+++ b/libeufin/api-sandbox.rst
@@ -9,16 +9,33 @@ HTTP API
 ..
   Payments.
 
+.. http:get:: /admin/payments
+
+   Return the list of *all* the payments known by the sandbox.
+
+   **Response**
+
+   .. code-block:: tsref
+
+     interface SandboxPayments {
+
+       // The list of all known payments, regardless
+       // of any IBAN involved in them.
+       payments: SandboxPayment[];
+     }
+
 .. http:post:: /admin/payments
 
    Adds a new payment to the book.  Mainly used for testing
    purposes.
 
    **Request:**
+   
+   One object of type `SandboxPayment`
 
-    .. ts:def:: PaymentRequest
+    .. ts:def:: SandboxPayment
 
-     interface PaymentRequest {
+     interface SandboxPayment {
 
        // IBAN that will receive the payment.
        creditorIban: string;