> ## 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 a purchase order

> Returns a single purchase order with all lines.

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

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

<ParamField path="orderId" type="string" required>
  Purchase order UUID.
</ParamField>

<ResponseField name="purchase_order" type="object">
  Full purchase order detail including all lines.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "purchase_order": {
      "id": "po_01j5k...",
      "account_id": "acc_01...",
      "vendor_id": "vnd_01...",
      "supplier_id": "sup_best_foods_01...",
      "store_id": "str_main_01...",
      "status": "DRAFT",
      "expected_delivery_at": "2026-08-14T15:00:00.000Z",
      "submitted_at": null,
      "confirmed_at": null,
      "cancelled_at": null,
      "closed_at": null,
      "external_reference": null,
      "notes": "Weekly protein order",
      "metadata": {},
      "created_at": "2026-08-11T12:00:00.000Z",
      "updated_at": "2026-08-11T12:00:00.000Z",
      "lines": [
        {
          "id": "pol_01...",
          "item_id": "itm_chicken_01...",
          "qty": 10,
          "qty_base": 10000,
          "unit_label": "kg",
          "unit_cost": 4.5
        }
      ]
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "kind": "purchase_order_not_found",
      "message": "Purchase order not found"
    }
  }
  ```
</ResponseExample>