Tracking: Browse Packages
list_packages[Tracking / Logistics]
[What it does] Lists account-owned packages by normalized logistics status; read-only.
[When to use] Use when packages that are pending, in transit, delivered, in an exception state, or flagged for attention are needed.
[When not to use] For the tracking events of one known package, use get_package_details instead of this tool.
[How to use] Filter with status=all, status=pending, status=in_transit, status=delivered, status=abnormal (all exception packages), or status=attention (flagged packages). You can also filter by order/tracking keyword, store, supplier platform, order age, or Unix time range; page_size caps at 100; reuse the previous next_cursor to page. An empty items array is valid; has_more=true means more results remain.
[Side effects] Read-only.
[Confirmation] No confirmation required.
[Follow-up] If a package is in an exception or appears overdue, inspect it with get_package_details; otherwise report the result and stop.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_packages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cursor | No | Opaque next_cursor returned by a previous call. | |
| status | No | Tracking tab: all, pending, in_transit, delivered, abnormal (exceptions), attention (flagged). | |
| keyword | No | Order or tracking number search text. Optional. | |
| end_time | No | Optional Unix end timestamp. | |
| page_size | No | Items per page, up to 100. | |
| search_by | No | How keyword should be interpreted. | |
| sort_order | No | Creation-time sort order. | desc |
| start_time | No | Optional Unix start timestamp. | |
| dsers_store_id | No | Optional DSers store ID as a decimal string. | |
| detail_statuses | No | Optional detailed logistics statuses. Paste JSON example: ["awaiting_shipment","in_global_transit"]. | |
| sales_order_age_days | No | Optional sales-order age in days. | |
| supplier_platform_id | No | Optional supplier platform application ID as a decimal string. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Tracking packages | |
| counts | Yes | Package counts by tracking tab | |
| pagination | Yes | Stable cursor pagination | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |