Procurement > PoFieldValue

Reads all Po field values

Changed on

Fetch field values for a purchase order.

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

Request

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

Query parameters

ids[]string[]

An array of field value IDs to filter by.

[
  "1"
]
purchase_order_ids[]string[]

An array of purchase order IDs to filter values for.

[
  "1"
]
line_item_ids[]string[]

Restrict results to values belonging to these line items. Header-level values (not associated with any line item) are never returned when this is set. Mutually exclusive with exclude_line_items=true — combining both returns no results.

[
  "1"
]
exclude_line_itemsboolean

When true, excludes per-line values and returns only values not associated with any line item (i.e. header-level). Mutually exclusive with line_item_ids.

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "company_id": "1",
      "purchase_order_id": "1",
      "field_definition_id": "1",
      "value": "Innovate Tech",
      "display_value": "Innovate Tech Solutions",
      "created_at": "2025-01-01T00:00:00.000Z",
      "updated_at": "2025-01-01T00:00:00.000Z"
    }
  ]
}

Changes