Worker qualification

Competencies, certificates and licences held by workers: rigging, EWP, first aid and so on.

Part of Workforce in the register catalog.

Register ID

worker_qualificationUse 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
• ISO 30414Human capital reportingInternational

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
• HammerTech
• MittiPartial
• SignOnSitePartial
• SitematePartial

Fields

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

Required

Every record carries these fields.

external_idText

The composite source key <user_id>:<competency_id>, cast to text.

Example: 5501:C-4471

source_systemText

Which bound system emitted the row; ASSIGNAR today.

Example: ASSIGNAR

occurred_atDate and timeISO 8601, with time zone

When the qualification was issued.

Example: 2025-11-03T00:00:00Z

workerText

The worker who holds the qualification.

Example: 5501

competencyGroup of fields

The qualification, certificate or licence held; the created competency entity, labelled from competency.name, joined to the worker by the worker_holds_competency edge.

Optional

Present when the source system records them.

expiry_dateDateYYYY-MM-DD

The date the qualification lapses — the field a compliance-by-exception reader needs.

Example: 2030-11-03

competence_statusText

The source's status flag for the assignment (active/inactive, or a verification state)

Example: active

competency_codeText

The stable vendor id of the competency type, so a title edit does not fork the entity.

Example: WC-GC

source_record_idText

The source competency-assignment row's own id, for provenance.

Example: AR-99201

evidence_referenceText

A reference to the evidence document for the qualification.

Example: doc://compliance/whitecard/5501.pdf

financial_periodDateYYYY-MM-DD

The accounting period the issue date falls in, derived from occurred_at

Example: 2025-11-01

Defined by each organisation

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

descriptionText

The tenant's own free-text description of the qualification.

Example: General construction induction card

Example record

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

worker_qualification.example.json

{
  "competence_status": "active",
  "competency": {
    "code": "WC-GC",
    "name": "White Card - General Construction Induction"
  },
  "competency_code": "WC-GC",
  "description": "General construction induction card",
  "evidence_reference": "doc://compliance/whitecard/5501.pdf",
  "expiry_date": "2030-11-03",
  "external_id": "5501:C-4471",
  "financial_period": "2025-11-01",
  "occurred_at": "2025-11-03T00:00:00Z",
  "source_record_id": "AR-99201",
  "source_system": "ASSIGNAR",
  "worker": "5501"
}

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/worker_qualification/v1.json

Show the full JSON Schema

Loading the schema…