---
title: "Reads all Purchase orders"
method: GET
path: "/api/2026-07-01/resources/procurement/purchase_orders"
tags: ["Procurement > PurchaseOrder"]
---

# Reads all Purchase orders

`GET /api/2026-07-01/resources/procurement/purchase_orders`

Fetch one or all purchase orders for the company.

## Query parameters

- `ids[]` string[] — An array of purchase order IDs to filter by.
- `purchase_request_ids[]` string[] — An array of purchase request IDs to filter by.
- `status` 'processing' | 'draft' | 'pending' | 'ordered' | 'partial' | 'received' | 'closed' — Status to filter by.
- `vendor_ids[]` string[] — Vendor IDs to filter by.

## Response `200`

OK

- object
  - `data` ProcurementPurchaseOrder[]
    - `id` string, required — Unique identifier of the purchase order
    - `po_number` integer, required — Purchase order number assigned to this order
    - `description` string, required — Description or notes about the purchase order
    - `status` 'processing' | 'draft' | 'pending' | 'ordered' | 'partial' | 'received' | 'closed', required — Current status of the purchase order
    - `cost` object, required — Total cost of the purchase order
    - `date` string, required — Date when the purchase order was created
    - `vendor_id` string — Identifier of the vendor (contact) associated with this purchase order
    - `purchase_request_id` string — Identifier of the purchase request that generated this purchase order, if any. Externally-created purchase orders (e.g. synced from an ERP) have no purchase request.
    - `legal_entity_id` string, required — Identifier of the legal entity that owns this purchase order
    - `company_id` string, required — Identifier of the company that owns this purchase order
    - `formatted_po_number` string, required — Formatted purchase order number with prefix (e.g., PO-00001)
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/versions/1a6bffb20f7d/schema)