> ## 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.

# List purchase orders

> Returns purchase orders for a vendor with optional filters.

<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 query="store_id" type="string">
  Filter by store UUID.
</ParamField>

<ParamField query="supplier_id" type="string">
  Filter by supplier UUID.
</ParamField>

<ParamField query="status" type="string">
  Filter by status: `DRAFT`, `SUBMITTED`, `CONFIRMED`, `PARTIALLY_RECEIVED`, `RECEIVED`, `CLOSED`, or `CANCELLED`.
</ParamField>

<ParamField query="external_reference" type="string">
  Filter by the client-supplied external reference (e.g. ERP movement code).
</ParamField>

<ParamField query="limit" type="number">
  Results per page (1–200, default 50).
</ParamField>

<ParamField query="offset" type="number">
  Pagination offset (default 0).
</ParamField>

<ResponseField name="items" type="object[]">
  Purchase orders with their lines.
</ResponseField>

<ResponseField name="total" type="number">
  Total matching records.
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "po_01j5k...",
        "supplier_id": "sup_best_foods_01...",
        "store_id": "str_main_01...",
        "status": "SUBMITTED",
        "expected_delivery_at": "2026-08-14T15:00:00.000Z",
        "external_reference": null,
        "created_at": "2026-08-11T12:00:00.000Z"
      }
    ],
    "total": 1,
    "limit": 50,
    "offset": 0
  }
  ```
</ResponseExample>