FAfactorialhr
Procurement > PoTemplateVersion

Reads all Po template versions

Changed on

Fetch PO template versions for the company. A version is the immutable snapshot of a template's schema: it owns the field definitions a purchase order created against it must comply with. To introspect the schema an integrator will write POs against, request the active version (status=active) and read its field definitions. To update a purchase order created with an older template, request the specific historical version by id (purchase_order.po_template_version_id) so the correct schema is used.

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

Request

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

Query parameters

ids[]string[]

An array of PO template version IDs to filter by. Use the po_template_version_id pinned on a purchase order to retrieve the exact (possibly historical, non-active) schema it was created with.

[
  "1"
]
po_template_ids[]string[]

An array of PO template IDs to filter versions for.

[
  "1"
]
status[]string[]

Filter by version status. Use "active" to retrieve the single currently-active version of each template (the schema new POs are created against). Other values: "draft", "archived".

[
  "active"
]

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "po_template_id": "1",
      "company_id": "1",
      "version_number": 1,
      "status": "active",
      "created_by_id": "20",
      "published_by_id": "20",
      "published_at": "2025-01-01T00:00:00.000Z",
      "created_at": "2025-01-01T00:00:00.000Z",
      "updated_at": "2025-01-01T00:00:00.000Z"
    }
  ]
}

Changes