change GET /tips to GET /private/tips

1 files changed, 9 insertions, 9 deletions

diff --git a/core/api-merchant.rst b/core/api-merchant.rst
index 3bde039d..03aefed7 100644
--- a/core/api-merchant.rst
+++ b/core/api-merchant.rst
@@ -1957,14 +1957,17 @@ Giving Customer Tips
 
 
 
-.. http:get:: /tips
+.. http:get:: /private/tips
 
   Return the list of all tips.
 
   **Request:**
 
-  :query expired: *Optional*. If set to "yes", the response also includes
-    tips that have expired. Otherwise only unexpired tips are returned.
+  :query include_expired: *Optional*. If set to "yes", the result includes expired tips also. Otherwise, only active tips are returned.
+
+  :query limit: *Optional*. At most return the given number of results. Negative for descending in database row id, positive for ascending in database row id.
+
+  :query offset: *Optional*. Starting row_id for an iteration.
 
   **Response:**
 
@@ -1984,17 +1987,14 @@ Giving Customer Tips
 
     interface Tip {
 
+      // id of the tip in the backend database
+      row_id: number;
+
       // Unique identifier for the tip.
       tip_id: HashCode;
 
-      // Exchange from which the tip will be withdrawn.
-      exchange_url: string;
-
       // (remaining) amount of the tip (including fees).
       tip_amount: Amount;
-
-      // Timestamp indicating when the tip is set to expire (may be in the past).
-      expiration: Timestamp;
     }