get-orders
Retrieve Shopify orders with optional status filters, pagination, and field selection; return only needed fields or a count to reduce context usage.
Instructions
Get orders with optional filtering by status. Supports field selection via 'fields' and 'countOnly' to get just the count.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Cursor for forward pagination | |
| limit | No | Number of orders to return (default 10, max 250) | |
| query | No | Raw query string for advanced filtering (e.g. 'financial_status:paid fulfillment_status:shipped') | |
| before | No | Cursor for backward pagination | |
| fields | No | IMPORTANT: Always specify this to minimize token usage and avoid flooding context with unnecessary data. Only the listed fields will be fetched from the API and returned. 'id' is always included. If you are unsure which fields are needed, ask the user before fetching all fields. Example: ["id", "name"] returns only order GID and name. Available: id, name, createdAt, financialStatus, fulfillmentStatus, totalPrice, subtotalPrice, shippingPrice, tax, customer, shippingAddress, lineItems, tags, note | |
| status | No | any | |
| reverse | No | Reverse the sort order | |
| sortKey | No | Sort key for orders | |
| countOnly | No | IMPORTANT: Use this to check result set size before fetching data. Returns only { count: N } without any resource data, saving significant context. Recommended before paginating large result sets. |