FAfactorialhr
Procurement > PurchaseOrder

Reads all Purchase orders

Changed on

Fetch one or all purchase orders for the company.

get/api/2026-10-01/resources/procurement/purchase_orders

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/procurement/purchase_orders
  • Auth
    API key in header x-api-key

Query parameters

ids[]string[]

An array of purchase order IDs to filter by.

[
  "678432"
]
purchase_request_ids[]string[]

An array of purchase request IDs to filter by.

[
  "5678"
]
status'processing' | 'draft' | 'pending' | 'ordered' | 'partial' | 'received' | 'closed'

Status to filter by.

Example:pending
vendor_ids[]string[]

Vendor IDs to filter by.

[
  "9012"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "678432",
      "po_number": 2131,
      "description": "Office supplies for Q1 2025",
      "status": "pending",
      "cost": {
        "cents": 10000,
        "currency": "EUR"
      },
      "date": "2025-01-15",
      "deadline": "2025-02-15",
      "vendor_id": "9012",
      "purchase_request_id": "5678",
      "legal_entity_id": "3456",
      "company_id": "1",
      "formatted_po_number": "PO-02131",
      "preferred_payment_method": "banktransfer",
      "po_template_version_id": "1",
      "header_field_values_by_key": [
        {
          "field_key": "delivery_notes",
          "value": "Leave at reception"
        }
      ],
      "line_items_by_key": [
        {
          "id": 51,
          "position": 0,
          "fields": [
            {
              "field_key": "quantity",
              "value": "10"
            }
          ]
        }
      ]
    }
  ]
}

Changes