Get order status
get_order_statusCustomer-facing status, ETA window and next action for an order. Looked up by the buyer's private order token, issued after payment; the token is the only credential. Never returns address, phone or payment details.
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": {
"order_token": "<order_token>"
},
"name": "get_order_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Language of the conversation with the user (e.g. he-IL, fr-FR). Localizes content and messages; prices and availability are unaffected. | |
| order_token | Yes | The order token from the buyer's confirmation email (GR-XXXXX-…). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gift | No | ||
| error | No | Present only when the call failed | |
| locale | No | BCP-47 locale the texts are localized to | |
| status | No | Machine status, e.g. confirmed | on_the_way | delivered | needs_attention | |
| country | No | ||
| updated_at | No | ||
| next_action | No | ||
| display_text | No | Human-readable one-line summary of the result | |
| status_label | No | ||
| delivery_date | No | ||
| estimated_window | No |