List orders
Orders from the All Orders page, filtered by search text, status, channel or date, with items and ticket link.
MCP tool edesk_read → list_orders
read
Lists orders the way All Orders shows them, newest first. query matches the order number, customer details, product name or SKU. status is the order status as eDesk shows it, for example Order Shipped. ticket_id is set when the order is linked to a ticket. Use order_id with get_order. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Order number, customer name or email, product name or SKU. |
| status string | string | Order status as eDesk shows it, for example Order Shipped. |
| channel_id integer | integer | Channel ID from list_channels. |
| since date | date | Only orders placed on or after this date (YYYY-MM-DD). |
| limit integer | integer | How many items to return per page. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "edesk_read",
"arguments": {
"operation": "list_orders",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"orders": [
{
"order_id": 90412,
"order_number": "203-7718305-2294466",
"channel": "Amazon UK - Brightside Home",
"status": "In transit",
"ordered_at": "2026-10-08",
"shipped_at": "2026-10-09",
"total": "GBP 84.90",
"items": [
{
"sku": "BH-KETTLE-1L",
"product": "Glass kettle 1 L",
"quantity": 1
}
],
"ticket_id": 48210
}
],
"next_cursor": null
},
"isError": false
}