Compliance state

Current compliance status for one area of a legal entity: a scheme, obligation or requirement.

Part of Safety in the register catalog.

Register ID

compliance_stateUse 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

DeclaredDefined, and fills when a source produces its first record.

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.

• NPSNational Prequalification System for civil constructionAustralia

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.

• HammerTechPartial
• MittiPartial
• SignOnSitePartial
• SitematePartial

Fields

29 fields: 17 required, 12 optional.

Required

Every record carries these fields.

subject_entity_idWhole number

The org the standing belongs to; the shared subject of all four kinds.

Example: 4210

shelf_typeText

The concrete pattern instance compliance_state:{record_kind}:{fact_key}; today the only carrier of the record kind and the per-record key.

Example: compliance_state:obligation:obligation:nps_annual_financi…

record_kindTextUnit: scheme \

obligation \.

Example: obligation

fact_keyText

The per-record key inside the kind: profile, scheme:{scheme_key}, obligation:{obligation_key}, the requirement key.

Example: obligation:nps_annual_financial_accounts

source_systemText

The writer identity; DEMITON for all four kinds today.

Example: DEMITON

source_idText

The idempotency key the writer mints (today shelf_type + fact key + the accept_fact date part)

Example: compliance_state:obligation:nps_annual_financial_accounts…

as_ofDate and timeISO 8601, with time zone

When the standing was last asserted by the org — the read-time clock for every derived status.

Example: 2026-07-01T00:00:00Z

statusText

The standing's own state; today scheme.status defaults "active" (:245) and requirement.status is free-ish with not_assessed expressed as absence (:1523-1528)

Example: current

declaredTrue or false

Self-declared by the org, as opposed to evidenced.

Example: true

scheme_keyText

The catalog scheme/panel this row belongs to (nps, iso45001, …, or panel:{key})

Example: nps

jurisdictionsList

The jurisdictions the org declares it operates/contracts in.

max_contract_valueText

The largest contract value the org declares it can take.

Example: 100

obligation_keyText

Stable key for a recurring obligation: catalog id for a template, custom:{slug} for a user-added one.

Example: nps_annual_financial_accounts

titleText

The human name of the obligation/requirement (for a scheme, its catalog label)

Example: NPS annual financial accounts

cadenceTextUnit: biennial \

triennial \.

Example: annual

is_activeTrue or false

Whether the org still carries the obligation (inactive rows are kept visible, never retired)

Example: true

requirement_idText

The clause/scheme-requirement identifier being adhered to.

Example: nps-financial-accounts

Optional

Present when the source system records them.

effective_fromDateYYYY-MM-DD

The date the declared standing took effect.

expires_atDateYYYY-MM-DD

When the holding or the next evidence obligation lapses.

classificationsGroup of fields

The declared levels on one scheme, e.g. the NPS A/B/F/R level set.

contract_value_rangeText

The org's declared typical contract value range.

completed_atDate and timeISO 8601, with time zone

When the org finished the standing wizard.

descriptionText

What the obligation requires.

Example: Submit audited annual financial accounts to maintain NPS …

next_dueDateYYYY-MM-DD

When the obligation next falls due.

Example: 2027-07-01

last_completed_atDateYYYY-MM-DD

When it was last satisfied.

sourceText

Provenance of the obligation row (template today)

evidence_idWhole number

The evidence artefact backing the adherence claim.

noteText

Free-text assessor note.

valid_untilDate and timeISO 8601, with time zone

Supersession stamp; the live row is valid_until IS NULL

Example record

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

compliance_state.example.json

{
  "as_of": "2026-07-01T00:00:00Z",
  "cadence": "annual",
  "declared": true,
  "description": "Submit audited annual financial accounts to maintain NPS financial-capacity classification F100.",
  "fact_key": "obligation:nps_annual_financial_accounts",
  "is_active": true,
  "jurisdictions": [
    "qld"
  ],
  "max_contract_value": "100",
  "next_due": "2027-07-01",
  "obligation_key": "nps_annual_financial_accounts",
  "record_kind": "obligation",
  "requirement_id": "nps-financial-accounts",
  "scheme_key": "nps",
  "shelf_type": "compliance_state:obligation:obligation:nps_annual_financial_accounts",
  "source_id": "compliance_state:obligation:nps_annual_financial_accounts:2026-07-01",
  "source_system": "DEMITON",
  "status": "current",
  "subject_entity_id": 4210,
  "title": "NPS annual financial accounts"
}

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

Show the full JSON Schema

Loading the schema…