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

# Get suggested order

> Returns a recommended purchase order: items whose current stock is below their par level, with the gap quantity expressed in base units.

<ParamField header="x-api-key" type="string" required>
  API key with `catalog:read` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField query="store_id" type="string" required>
  UUID of the store to compute suggestions for.
</ParamField>

<ParamField query="supplier_id" type="string">
  Filter suggestions to items supplied by this supplier UUID.
</ParamField>

<ResponseField name="items" type="object[]">
  Suggested reorder lines. Each entry includes `item_id`, `item_name`, current balance, par level, gap quantity, and the suggested unit details.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "item_id": "itm_chicken_01...",
        "item_name": "Chicken breast",
        "current_qty_base": 3000,
        "par_qty_base": 10000,
        "gap_qty_base": 7000,
        "base_unit_id": "unit_g_01...",
        "base_unit_symbol": "g"
      }
    ]
  }
  ```
</ResponseExample>