Retrieve a list of orders
Changed onRetrieve a list of orders
Request
- Base URLhttps://api.printify.com
- URLhttps://api.printify.com/v1/shops/{shop_id}/orders.json
- AuthHTTP bearer
Query parameters
Results per page (default: 10, maximum: 10)
Paginate through list of results
Filter results by order status
Filter results by product SKU - response will contain only those orders that have at least one product with passed SKU
Response
Successful operation
Example response
{
"current_page": 1,
"data": [
{
"id": "5a6e03bd2f7d8055768923c8",
"app_order_id": "215014.44",
"address_to": {
"first_name": "Jane",
"last_name": "Smith",
"address1": "ExampleBaan 121",
"address2": "Apt 4B",
"city": "Retie",
"zip": "2470",
"email": "example@msn.com",
"phone": "0574 69 21 90",
"country": "BE",
"company": "MSN"
},
"line_items": [
{
"id": "5a96f649b2439217d070f508",
"product_id": "5b05842f3921c9547531758d",
"blueprint_id": 384,
"quantity": 1,
"variant_id": 17887,
"print_provider_id": 5,
"cost": 1050,
"shipping_cost": 400,
"status": "fulfilled",
"status_details": "out_of_stock",
"metadata": {
"title": "18K gold plated Necklace",
"price": 2200,
"variant_label": "Golden indigocoin",
"sku": "168699843",
"country": "United States",
"external_id": "line-item-abc-001",
"reprinted_line_item_id": "5d6c3b0f2a1e4c0012345678"
},
"sent_to_production_at": "2017-04-18 13:24:28+00:00",
"fulfilled_at": "2017-04-18 13:24:28+00:00",
"estimated_ship_at": "2026-10-23T00:00:00.000Z",
"estimated_delivery_at": "2026-10-28T00:00:00.000Z"
}
],
"metadata": {
"order_type": "external",
"shop_order_id": 1370762297,
"shop_order_label": "1370762297",
"shop_fulfilled_at": "2017-04-18 13:24:28+00:00",
"reprinted_order_ids": [],
"child_reprinted_order_ids": []
},
"total_price": 2200,
"total_shipping": 400,
"status": "fulfilled",
"shipping_method": 1,
"shipments": [
{
"carrier": "usps",
"number": "94001116990045395649372",
"url": "http://example.com/94001116990045395649372",
"delivered_at": "2017-04-18 13:24:28+00:00",
"line_item_ids": [
"5e7b3a9c1f2d4a0012345678"
]
}
],
"created_at": "2017-04-18 13:24:28+00:00",
"sent_to_production_at": "2017-04-18 13:24:28+00:00",
"fulfilled_at": "2017-04-18 13:24:28+00:00",
"printify_connect": {
"url": "https://example.com/printify_connect_hash",
"id": "printify_connect_hash"
}
}
],
"first_page_url": "/?page=1",
"from": 1,
"last_page": 22,
"last_page_url": "/?page=22",
"next_page_url": "/?page=2",
"path": "/",
"per_page": 1,
"to": 1,
"total": 22
}Changes
- info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status - info
added the optional property
/////to the response with the status - info
added the optional property
//////to the response with the status - info
added the optional property
/////to the response with the status - info
added the required property
////to the response with the status
- info
- info
added the optional property
/////to the response with the status
- info