---
title: "Reads all Po field values"
method: GET
path: "/api/2026-10-01/resources/procurement/po_field_values"
tags: ["Procurement > PoFieldValue"]
---

# Reads all Po field values

`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`

Fetch field values for a purchase order.

## Query parameters

- `ids[]` string[]: An array of field value IDs to filter by.
- `purchase_order_ids[]` string[]: An array of purchase order IDs to filter values for.
- `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.
- `exclude_line_items` boolean: 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 `200`

OK

- object
  - `data` ProcurementPoFieldValue[]
    - `id` string, required: The id of the field value
    - `company_id` string, required: Identifier of the company
    - `purchase_order_id` string, required: The purchase order this value belongs to
    - `field_definition_id` string, required: The field definition this value corresponds to
    - `line_item_id` string: The line item this value belongs to (null for header-level values)
    - `value` string: The stored value as a string (type-cast based on field definition)
    - `display_value` string: Human-readable display name for entity-type fields (resolved at read time)
    - `created_at` string, required: When this field value was created
    - `updated_at` string, required: When this field value was last updated
  - `meta` PagedIndexMeta
    - `start_cursor` string
    - `end_cursor` string
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `limit` integer, required
    - `total` integer, required

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/procurement/po_field_values/get.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)