List orders
Orders of your store, newest first, filtered by status.
MCP tool printful_read → list_orders
read
Returns one page of orders with ID, status, recipient name, item count and creation date. Without a status it returns every order. Use cursor to read on. The status follows the dashboard labels, for example Draft, Failed or Fulfilled.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | draft, failed, waiting_for_fulfillment, being_fulfilled, partially_fulfilled, fulfilled or canceled. Default: all. |
| limit integer | integer | Orders per page. Default 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "printful_read",
"arguments": {
"operation": "list_orders",
"arguments": {
"status": "failed",
"limit": 20
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"orders": [
{
"order_id": 31911,
"status": "draft",
"recipient": "Anna Berg",
"items": 2,
"created_at": "2026-10-17T07:12:00Z"
},
{
"order_id": 31877,
"status": "failed",
"recipient": "Mia Alvarez",
"items": 2,
"created_at": "2026-10-16T22:40:00Z"
}
],
"next_cursor": null
},
"isError": false
}