Competency verification

Verification-of-competency assessments per worker.

Part of Workforce in the register catalog.

Register ID

competency_verificationUse 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.2

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.

• EROADPartial
• HammerTechPartial
• Mitti
• SignOnSitePartial
• SitematePartial

Fields

10 fields: 4 required, 4 optional, 2 defined by each organisation.

Required

Every record carries these fields.

external_idText

The source form-result's own identifier, as text.

Example: FR-88231

source_systemText

Which bound system emitted the row; ASSIGNAR today.

Example: ASSIGNAR

occurred_atDate and timeISO 8601, with time zone

When the verification was submitted; the date the 365-day compliance clock runs from.

Example: 2026-07-10T09:00:00Z

workerNumber

The worker the verification is about.

Example: 5503

Optional

Present when the source system records them.

financial_periodDateYYYY-MM-DD

The accounting period the verification falls in, derived from occurred_at

Example: 2026-07-01

form_idNumber

The source form template identity the verification was captured on.

Example: 512

competencyText

The competency entity the verification created, whose name is the form title.

Example: Traffic Control Certification

assetNumber

The plant/equipment the verification relates to, when it resolves

Defined by each organisation

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

submissionGroup of fields

The tenant's own verification form — its question labels and answers, including the licence/certificate evidence the form captures.

title_labelText

The tenant's own name for the competency, taken from the form title.

Example: Traffic Control Certification

Example record

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

competency_verification.example.json

{
  "competency": "Traffic Control Certification",
  "external_id": "FR-88231",
  "financial_period": "2026-07-01",
  "form_id": 512,
  "occurred_at": "2026-07-10T09:00:00Z",
  "source_system": "ASSIGNAR",
  "title_label": "Traffic Control Certification",
  "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/competency_verification/v1.json

Show the full JSON Schema

Loading the schema…