*Workflows › Reference › Actions › Purchasing*

# List purchase orders

> Lists purchase orders with the public contract's filters and pagination.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `purchaseOrders` |
| Group in the editor | Purchasing › Purchase orders |
| Runs as | The owner of the workflow, with their permissions |
| Permission | View access to Purchases. Administrators always pass; a module outside the plan blocks everyone. |
| Add-on | Purchases |
| Destructive | No: the public MCP catalogue does not mark it as destructive |
| Also available in | REST API, MCP (`filmo_purchase_orders_list`) |

ACTION `purchaseOrders.findMany`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | number | No |  = `100` |
| `createdOn` | string | No |  |
| `createdAfter` | string | No |  |
| `createdBefore` | string | No |  |
| `createdFrom` | string | No |  |
| `createdTo` | string | No |  |
| `updatedOn` | string | No |  |
| `updatedAfter` | string | No |  |
| `updatedBefore` | string | No |  |
| `updatedFrom` | string | No |  |
| `updatedTo` | string | No |  |
| `status` | enum<string> | No |  `draft`, `pending`, `completed`, `cancelled` |
| `statuses` | string[] | No | Filter by status, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. `draft`, `pending`, `completed`, `cancelled` |
| `type` | enum<string> | No |  `subrental`, `stock_purchase`, `resale_purchase`, `consumable_purchase`, `technician`, `transport`, `repair`, `consignment` |
| `types` | string[] | No | Filter by type, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. `subrental`, `stock_purchase`, `resale_purchase`, `consumable_purchase`, `technician`, `transport`, `repair`, `consignment` |
| `supplierId` | string | No |  |
| `supplierIds` | string[] | No | Filter by supplierId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |
| `orderId` | string | No |  |
| `orderIds` | string[] | No | Filter by orderId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |
| `projectId` | string | No |  |
| `projectIds` | string[] | No | Filter by projectId, as a list: repeat the parameter or separate the values with commas. Accepts up to 50 values and returns whatever matches any of them. |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `items` | object[] |  |
| `items.id` | string |  |
| `items.poNumber` | string |  |
| `items.status` | enum<string> |  `draft`, `pending`, `completed`, `canceled` |
| `items.type` | enum<string> |  `subalquiler`, `compra_stock`, `compra_para_venta`, `compra_consumible`, `tecnico`, `transporte`, `reparacion`, `consignment` |
| `items.isDraft` | boolean |  |
| `items.poDate` | string |  |
| `items.supplierId` | string |  |
| `items.reference` | string |  |
| `items.currency` | string |  |
| `items.subTotal` | string |  |
| `items.discountTotal` | string |  |
| `items.taxesPrice` | string |  |
| `items.netPrice` | string |  |
| `items.grossPrice` | string |  |
| `items.totalPaid` | string |  |
| `items.orderId` | string |  |
| `items.orderNumber` | string |  |
| `items.projectId` | string |  |
| `items.repairTicketId` | string |  |
| `items.notes` | string |  |
| `items.createdAt` | string |  |
| `items.updatedAt` | string |  |
| `total` | number |  |
| `nextCursor` | string |  |

---

Canonical URL: https://docs.filmo.io/workflows/reference/actions/purchaseorders-findmany  
Last updated: 2026-10-25