List orders
Orders in a shop with status, total and line items, filtered by status or SKU.
GET https://cotlet.dev/api/v1/printify/shops/{shop_id}/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. |
Request
curl "https://cotlet.dev/api/v1/printify/shops/8123456/orders?status=has-issues" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("printify", "list_orders", {"shop_id":8123456,"status":"has-issues"})const result = await cotlet.call('printify', 'list_orders', {"shop_id":8123456,"status":"has-issues"});cotlet call printify list_orders --data '{"shop_id":8123456,"status":"has-issues"}'Example response
{
"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
}