> ## Documentation Index
> Fetch the complete documentation index at: https://developer.lulacommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order Items

> Retrieve detailed information for a specific item within an order including pricing, modifications, and special instructions.

This endpoint provides comprehensive details for a specific item within an order. Use this when you need detailed information about a particular order item for customer service, inventory tracking, or fulfillment purposes.

<Info>
  This endpoint returns complete item details including product information, pricing breakdown, modifications, and fulfillment status.
</Info>

### Path Parameters

<ParamField path="order_id" type="string" required>
  The unique identifier of the order containing the item
</ParamField>

<ParamField path="order_item_id" type="string" required>
  The unique identifier of the specific order item to retrieve
</ParamField>

### Response

<ResponseField name="id" type="string">
  Unique order item identifier
</ResponseField>

<ResponseField name="quantity" type="integer">
  Quantity of this item ordered
</ResponseField>

<ResponseField name="special_instructions" type="string">
  Item-specific preparation instructions
</ResponseField>

<ResponseField name="store_item_price" type="string">
  Price per unit for this item
</ResponseField>

<ResponseField name="store_item_total_price" type="string">
  Total price for this item (quantity × unit price)
</ResponseField>

<ResponseField name="store_item_name" type="string">
  Product name as displayed in store
</ResponseField>

<ResponseField name="store_item_description" type="string">
  Product description
</ResponseField>

<ResponseField name="store_item_category" type="string">
  Product category classification
</ResponseField>

<ResponseField name="store_item_size" type="string">
  Item size specification (if applicable)
</ResponseField>

<ResponseField name="item" type="object">
  Complete product information

  <Expandable title="Product Details">
    <ResponseField name="images" type="array">
      Array of product image URLs
    </ResponseField>

    <ResponseField name="name" type="string">
      Official product name
    </ResponseField>

    <ResponseField name="description" type="string">
      Detailed product description
    </ResponseField>

    <ResponseField name="upc" type="string">
      Universal Product Code (barcode)
    </ResponseField>

    <ResponseField name="categories" type="array">
      Product categories with IDs and names
    </ResponseField>

    <ResponseField name="subCategories" type="array">
      Product subcategories with IDs and names
    </ResponseField>

    <ResponseField name="storeItems" type="array">
      Store-specific product variations and pricing
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="modifications" type="array">
  Item modifications or customizations applied

  <Expandable title="Modification Details">
    <ResponseField name="modifier_id" type="string">Unique modifier identifier</ResponseField>
    <ResponseField name="modifier_name" type="string">Name of the modification</ResponseField>
    <ResponseField name="modifier_value" type="string">Selected modification value</ResponseField>
    <ResponseField name="additional_cost" type="string">Extra cost for this modification</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="fulfillment_status" type="string">
  Current fulfillment status for this specific item
</ResponseField>

<ResponseField name="preparation_notes" type="string">
  Internal notes for item preparation
</ResponseField>

### Response Example

```json theme={null}
{
  "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",
  "store_item_size": "1 count",
  "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": [
    {
      "modifier_id": "mod_size_large",
      "modifier_name": "Size",
      "modifier_value": "Large",
      "additional_cost": "0.50"
    }
  ],
  "fulfillment_status": "pending",
  "preparation_notes": "Handle with care - fragile packaging"
}
```

<Note>
  **Item Status**: The fulfillment\_status field shows the specific status of this item within the order, which may differ from the overall order status.
</Note>

<Tip>
  **Image Handling**: Product images are returned as URLs. Always check if the image URL is valid before displaying to avoid broken image links.
</Tip>

### Error Responses

<Accordion title="Common Error Scenarios">
  **Order Item Not Found**

  ```json theme={null}
  {
    "error": "Order item not found",
    "order_item_id": "invalid-item-id",
    "message": "The specified order item does not exist in this order"
  }
  ```

  **Order Not Found**

  ```json theme={null}
  {
    "error": "Order not found",
    "order_id": "invalid-order-id",
    "message": "The specified order does not exist"
  }
  ```

  **Access Denied**

  ```json theme={null}
  {
    "error": "Access denied",
    "message": "You do not have permission to view this order item"
  }
  ```
</Accordion>

### Use Cases

<Accordion title="Common Use Cases">
  **Customer Service**

  * Answer customer questions about specific items
  * Check item-specific special instructions
  * Verify product details and pricing

  **Fulfillment Management**

  * Check item preparation requirements
  * Review modification details
  * Track individual item status

  **Inventory Tracking**

  * Verify product information accuracy
  * Check UPC codes for scanning
  * Monitor item-level demand

  **Quality Control**

  * Review preparation notes
  * Check for special handling requirements
  * Verify modifications were applied correctly
</Accordion>

<Warning>
  **Performance**: Use this endpoint sparingly for individual item lookups. For bulk item information, use the "Get All Order Items" endpoint instead.
</Warning>