Certification register
Worker credentials and their expiry, as safety and site-access systems hold them.
Part of Workforce in the register catalog.
- Register ID
certification_registerUse this name to ask for the register. The API calls it a shelf ID.- Each record is
- A stateThe current value of something, replaced when it changes.
- Status
- PlannedDefined ahead of the connector that will fill it.
- Data
- OrganisationPrivate to each organisation's own workspace.
- Version
- v1Current version.
Connectors
Connected today
Demiton keeps this register current from these systems now.
No system fills this register yet.
On the roadmap
Systems in the planned connector rollout that can fill this register. Partial means the system holds only some of its fields.
None planned yet.
Fields
19 fields: 4 required, 15 optional.
Required
Every record carries these fields.
- external_idText
The source system's own credential id.
- source_systemText
Which bound system emitted the row.
- holderText
The worker who holds the credential.
- credential_typeText
What the credential is, e.g. a high-risk work licence.
Optional
Present when the source system records them.
- credential_type_codeText
The source's code for the credential type.
- credential_categoryText
The grouping the credential type belongs to.
- issued_onDate
When the credential was issued.
- expires_onDate
When the credential stops being valid.
- refresh_due_onDate
When the credential must be refreshed.
- issuerText
The body that issued the credential.
- training_organisationText
The registered training organisation that assessed it.
- registration_numberText
The number printed on the licence or ticket.
- referenceText
The source's own reference for the record.
- expiry_statusText
Valid, expired or expiring soon, as the source computed it.
- approval_statusText
Whether the credential has been checked and approved.
- is_customTrue or false
Whether the credential type was defined by the tenant rather than the source.
- siteText
The site the credential was recorded against.
- deletedTrue or false
Whether the source has deleted the credential.
- updated_atDate and time
When the record last changed at source.
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.
https://docs.demiton.io/registers/certification_register/v1.jsonShow the full JSON Schema
Loading the schema…
Talk to the team
Tell us what you run - your ERP, field, payroll and document systems - and we will show you the registers Demiton would keep current from them, on your data, in a 30-minute call.