This endpoint returns a comprehensive list of all items within an order. It’s ideal for order fulfillment, kitchen display systems, packing lists, and complete order review.
This endpoint provides complete item details for all items in an order, making it efficient for bulk operations and comprehensive order management.
Path Parameters The unique identifier of the order whose items you want to retrieve
Query Parameters Whether to include detailed modification information for each item
Filter items by fulfillment status: “pending”, “preparing”, “ready”, “completed”
Filter items by product category
Response The order identifier these items belong to
Total number of items in the order
Array of all order items with complete details Unique order item identifier
Quantity of this item ordered
Item-specific preparation instructions
Price per unit for this item
Total price for this item (quantity × unit price)
Product name as displayed in store
Product category classification
Current fulfillment status for this item
Complete product information including images, UPC, and categories
Applied modifications/customizations (when include_modifications=true)
Summary information for the complete order Total quantity of all items
Subtotal of all items before taxes
Count of items grouped by category
Count of items grouped by fulfillment status
Response Example { "order_id" : "35d18f08-6d54-421d-9476-8cef629111bc" , "total_items" : 2 , "items" : [ { "id" : "7fbe2819-5bc6-4340-8dfe-a5605272a32b" , "quantity" : 1 , "special_instructions" : "Cancel this order if this item is not available." , "store_item_price" : "1.00" , "store_item_total_price" : "1.00" , "store_item_name" : "Jumbo Ring Pop - 1" , "store_item_description" : "Jumbo Ring Pop" , "store_item_category" : "Others" , "fulfillment_status" : "pending" , "item" : { "images" : [ "https://example.com/product-image.jpg" ], "name" : "Jumbo Ring Pop" , "description" : "Jumbo Ring Pop" , "upc" : "4111626331" , "categories" : [ { "id" : "12bd6794-a17a-48a2-9a14-64c44a20c232" , "name" : "Others" } ], "subCategories" : [], "storeItems" : [ { "id" : "b7e9d9a6-2e3e-451a-ada9-6c001b17eaa5" , "price" : "10" , "external_id" : null , "location" : null , "name" : "Jumbo Ring Pop - 1" , "description" : null , "categories" : [ { "id" : "12bd6794-a17a-48a2-9a14-64c44a20c232" , "name" : "Others" } ], "subCategories" : [] } ] }, "modifications" : [] }, { "id" : "651daec0-c721-4399-82c8-2ac6afcc1160" , "quantity" : 4 , "special_instructions" : "Cancel this order if this item is not available." , "store_item_price" : "10.00" , "store_item_total_price" : "40.00" , "store_item_name" : "test new item 1" , "store_item_description" : "" , "store_item_category" : "Baby" , "fulfillment_status" : "preparing" , "item" : { "images" : null , "name" : "test new item 1" , "description" : "" , "upc" : null , "categories" : [ { "id" : "cef965f2-5a5a-4a30-b166-1350b4c3ff55" , "name" : "Baby" } ], "subCategories" : [ { "id" : "4a525cdb-2c2d-4d23-8764-d2c9f3c14142" , "name" : "For Mom" } ], "storeItems" : [ { "id" : "cf61e0c0-bff4-42dd-8273-1cbf4f8f5b42" , "price" : "10.00" , "external_id" : null , "location" : null , "name" : "test new item 1" , "description" : null , "categories" : [ { "id" : "3c185006-271c-4d1e-903f-de21ec3b4234" , "name" : "loo" } ], "subCategories" : [] } ] }, "modifications" : [] } ], "order_summary" : { "total_quantity" : 5 , "subtotal" : "41.00" , "items_by_category" : { "Others" : 1 , "Baby" : 1 }, "items_by_status" : { "pending" : 1 , "preparing" : 1 } } }
Get Items by Status GET {{micro_service_base_url}}/orders/{{order_id}}/order-items?status_filter=pending Get Items by Category GET {{micro_service_base_url}}/orders/{{order_id}}/order-items?category_filter=Baby Get Items Without Modifications GET {{micro_service_base_url}}/orders/{{order_id}}/order-items?include_modifications=false Performance Optimization : When you only need basic item information, set include_modifications=false to reduce response size and improve performance.
Kitchen Display : Use status_filter=pending to show only items that need preparation, perfect for kitchen display systems.
Use Cases
Order Fulfillment
Generate complete packing lists
Kitchen preparation workflows
Quality control checklists
Customer Service
Complete order review with customer
Item substitution discussions
Order modification consultations
Inventory Management
Track item demand patterns
Monitor category performance
Identify popular product combinations
Reporting & Analytics
Order composition analysis
Average order value calculations
Product performance metrics
Error Responses
Order Not Found { "error" : "Order not found" , "order_id" : "invalid-order-id" , "message" : "The specified order does not exist" } No Items Found { "order_id" : "35d18f08-6d54-421d-9476-8cef629111bc" , "total_items" : 0 , "items" : [], "message" : "No items found matching the specified criteria" } Access Denied { "error" : "Access denied" , "message" : "You do not have permission to view this order's items" } Large Orders : For orders with many items, consider using pagination or filters to manage response sizes and improve performance.
