List this session's orders
order_listList the orders created in this session, each with its live status.
Scoped to this session's own Order Records: an order placed
in another session, or by another caller, is not listed here — it is
reached through order_lookup with the customer's reference + email.
Whenever you tell the customer that only this conversation's orders can be
shown, also tell them they can see any other order of theirs by giving its
order reference and the email they used at checkout.
last is false when the session has more orders than one call shows
(only the most recent are returned); total_elements is the session's
true order count, so a false last means older orders exist beyond the
list.
Returns a job — poll until SUCCEEDED. On failure the job error is
RendrealNotConfiguredError (no client) or a Rendreal*Error — the
latter only when every listed order's status read fails (a systemic
outage); one failed read degrades that row to a null status and the job
still succeeds. An order deleted upstream is omitted from the list
entirely (and from total_elements), never shown as a pickable row.
The widget's picker commits an ordinal reference with the order's status
attached for disambiguation (e.g. "Nr 2 - Complete, please.") rather
than an id — 1-indexed against this same call's orders list, in
order. Map the number back to that list position's order_id before
calling order_get (these are this session's own orders, so no email is
needed); don't match on status alone (several orders can share one).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>"
},
"name": "order_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| session_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |