Policy acknowledgements

A worker's sign-off that a policy or procedure was read and accepted.

Part of Workforce in the register catalog.

Register ID

policy_acknowledgementsUse this name to ask for the register. The API calls it a shelf ID.

Each record is

An eventSomething that happened at a point in time.

Status

AvailableFilled today from connected systems, uploads or public data.

Data

OrganisationPrivate to each organisation's own workspace.

Version

v1Current version.

Download JSON SchemaSee an example record

Standards

This register holds records these standards and laws ask for. Holding them does not by itself certify compliance.

• ISO 45001Occupational health and safety management systemsInternational · Clause 7.3
• Fair Work Act 2009National employment standards and modern awardsAustralia

Connectors

Connected today

Demiton keeps this register current from these systems now.

• Assignar

On the roadmap

Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.

• SignOnSitePartial
• SitematePartial

Fields

13 fields: 6 required, 6 optional, 1 defined by each organisation.

Required

Every record carries these fields.

external_idText

Stable identity of the source record (Assignar form-result id, cast to text).

Example: ack-2026-1187

source_systemText

Originating system; ASSIGNAR today, SignOnSite if ever bound.

Example: ASSIGNAR

occurred_atDate and timeISO 8601, with time zone

When the acknowledgement form was submitted; the event time and the retention clock.

Example: 2026-07-06T07:15:00+10:00

workerNumber

The worker who acknowledged the policy; the required subject anchor.

Example: 5503

form_idNumber

The source form template id — which policy-document form produced the record.

Example: 481

acknowledgedTrue or false

Whether the worker's sign-off is present on the record.

Example: true

Optional

Present when the source system records them.

form_titleText

Human-readable template title; the policy document the form belongs to.

financial_periodDateYYYY-MM-DD

The accounting period the acknowledgement falls in, derived from occurred_at.

Example: 2026-07-31

policy_referenceText

The policy/procedure identifier or code the form is about.

Example: SWMS Review (QF-061)

policy_versionText

The revision of the policy that was acknowledged.

Example: v3

acknowledgement_methodText

How the acknowledgement was captured.

evidence_refGroup of fields

Reference to the signed form or attached evidence.

Defined by each organisation

Their contents come from the organisation's own forms or systems, so they differ between organisations.

attributesGroup of fields

Every remaining form answer, keyed by the tenant's own question text.

Example record

A sample from Bridgeworks Group, Demiton's demonstration company. The values are illustrative; the shape is exactly what the contract describes.

policy_acknowledgements.example.json

{
  "acknowledged": true,
  "external_id": "ack-2026-1187",
  "financial_period": "2026-07-31",
  "form_id": 481,
  "occurred_at": "2026-07-06T07:15:00+10:00",
  "policy_reference": "SWMS Review (QF-061)",
  "policy_version": "v3",
  "source_system": "ASSIGNAR",
  "worker": 5503
}

Use this contract

The contract is a standard JSON Schema (draft 2020-12) document, so any JSON Schema validator can check a record against it. Keywords starting with x-demiton- add Demiton's own meaning, such as units and requiredness, and validators ignore them.

Schema URL

https://docs.demiton.io/registers/policy_acknowledgements/v1.json

Show the full JSON Schema

Loading the schema…