commit 894a72cd0f5d7397f5b453d7a86795dea5307480
parent 8adbb987608e96c374e48a53e76f39e4bd16ff74
Author: Christian Grothoff <grothoff@gnunet.org>
Date: Sat, 21 Feb 2026 08:23:42 +0100
add max_age argument for #11127
Diffstat:
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/core/merchant/get-private-orders.rst b/core/merchant/get-private-orders.rst
@@ -11,7 +11,8 @@
:query wired: *Optional*. If set to yes, only return wired orders, if no only orders with missing wire transfers. Do not give (or use "all") to see all orders regardless of wire transfer status.
:query delta: *Optional*. takes value of the form ``N (-N)``, so that at most ``N`` values strictly older (younger) than ``start`` and ``date_s`` are returned. Defaults to ``-20`` to return the last 20 entries (before ``start`` and/or ``date_s``). Deprecated in protocol **v12**. Use *limit* instead.
:query limit: *Optional*. At most return the given number of results. Negative for descending by row ID, positive for ascending by row ID. Default is ``20``. Since protocol **v12**.
- :query date_s: *Optional.* Non-negative date in seconds after the UNIX Epoc, see ``delta`` for its interpretation. If not specified, we default to the oldest or most recent entry, depending on ``limit``.
+ :query date_s: *Optional.* Non-negative date in seconds after the UNIX Epoc. Only return orders created after the specified timestamp.
+ :query max_age: *Optional.* Relative time. Only return orders younger than the specified age. Since protocol **v27**.
:query start: *Optional*. Row number threshold, see ``limit`` for its interpretation. Defaults to ``INT64_MAX``, namely the biggest row id possible in the database. Deprecated in protocol **v12**. Use *offset* instead.
:query offset: *Optional*. Starting ``row_id`` for an iteration. Since protocol **v12**.
:query timeout_ms: *Optional*. Timeout in milliseconds to wait for additional orders if the answer would otherwise be negative (long polling). Only useful if ``limit`` is positive. Note that the merchant MAY still return a response that contains fewer than ``limit`` orders.
