List orders
Orders in a shop with status, total and line items, filtered by status or SKU.
MCP tool printify_read → list_orders
read
Lists orders of one shop. Filter by status, for example has-issues, on-hold, payment-not-received, in-production or fulfilled, or by SKU. Pages hold 10 orders at most, so page through the results. Totals are in cents.
Parameters
| Name | Type | Description |
|---|---|---|
| shop_id integer required | integer | Shop ID from list_shops. |
| status string | string | Order status, for example has-issues, on-hold, payment-not-received, in-production or fulfilled. |
| sku string | string | Only orders with at least one product with this SKU. |
| page integer | integer | Page number, starting at 1. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "printify_read",
"arguments": {
"operation": "list_orders",
"arguments": {
"shop_id": 8123456,
"status": "has-issues"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"orders": [
{
"order_id": "5a96f649b2439217d070f507",
"label": "1042",
"status": "has-issues",
"total_price": 2499,
"total_shipping": 450,
"created_at": "2026-10-16T09:12:00Z"
}
],
"page": 1,
"last_page": 1
},
"isError": false
}