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

# Listar órdenes de compra

> Devuelve las órdenes de compra del vendor con filtros opcionales.

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

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

<ParamField query="status" type="string">Filtrar por estado: `DRAFT`, `SUBMITTED`, `CONFIRMED`, `PARTIALLY_RECEIVED`, `CLOSED`, o `CANCELLED`.</ParamField>
<ParamField query="supplier_id" type="string">Filtrar por proveedor.</ParamField>
<ParamField query="store_id" type="string">Filtrar por establecimiento.</ParamField>
<ParamField query="from" type="string">Fecha de inicio (ISO 8601).</ParamField>
<ParamField query="to" type="string">Fecha de fin (ISO 8601).</ParamField>
<ParamField query="limit" type="number">Resultados por página (default 50).</ParamField>
<ParamField query="offset" type="number">Offset de paginación.</ParamField>

<ResponseField name="purchase_orders" type="object[]">Array de cabeceras de órdenes de compra.</ResponseField>
<ResponseField name="total" type="number">Total de registros.</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "purchase_orders": [
      {
        "id": "po_01...",
        "status": "SUBMITTED",
        "supplier_id": "sup_01...",
        "store_id": "str_principal_01...",
        "expected_delivery_date": "2026-08-10",
        "created_at": "2026-08-07T09:00:00.000Z"
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>