certification_register contract v1

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/certification_register/v1.json",
  "title": "certification_register contract v1",
  "type": "object",
  "required": [
    "credential_type",
    "external_id",
    "holder"
  ],
  "properties": {
    "site": {
      "type": "string",
      "description": "the site the credential was recorded against",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "holder": {
      "type": "string",
      "description": "the worker who holds the credential",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "issuer": {
      "type": "string",
      "description": "the body that issued the credential",
      "x-demiton-requiredness": "optional"
    },
    "deleted": {
      "type": "boolean",
      "description": "whether the source has deleted the credential",
      "x-demiton-requiredness": "optional"
    },
    "is_custom": {
      "type": "boolean",
      "description": "whether the credential type was defined by the tenant rather than the source",
      "x-demiton-requiredness": "optional"
    },
    "issued_on": {
      "type": "string",
      "description": "when the credential was issued",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "day",
      "format": "date",
      "x-demiton-type": "date"
    },
    "reference": {
      "type": "string",
      "description": "the source's own reference for the record",
      "x-demiton-requiredness": "optional"
    },
    "expires_on": {
      "type": "string",
      "description": "when the credential stops being valid",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "day",
      "format": "date",
      "x-demiton-type": "date"
    },
    "updated_at": {
      "type": "string",
      "description": "when the record last changed at source",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "external_id": {
      "type": "string",
      "description": "the source system's own credential id",
      "x-demiton-requiredness": "required"
    },
    "expiry_status": {
      "type": "string",
      "description": "valid, expired or expiring soon, as the source computed it",
      "x-demiton-requiredness": "optional"
    },
    "refresh_due_on": {
      "type": "string",
      "description": "when the credential must be refreshed",
      "x-demiton-requiredness": "optional",
      "x-demiton-unit": "day",
      "format": "date",
      "x-demiton-type": "date"
    },
    "approval_status": {
      "type": "string",
      "description": "whether the credential has been checked and approved",
      "x-demiton-requiredness": "optional"
    },
    "credential_type": {
      "type": "string",
      "description": "what the credential is, e.g. a high-risk work licence",
      "x-demiton-requiredness": "required"
    },
    "credential_category": {
      "type": "string",
      "description": "the grouping the credential type belongs to",
      "x-demiton-requiredness": "optional"
    },
    "registration_number": {
      "type": "string",
      "description": "the number printed on the licence or ticket",
      "x-demiton-requiredness": "optional"
    },
    "credential_type_code": {
      "type": "string",
      "description": "the source's code for the credential type",
      "x-demiton-requiredness": "optional"
    },
    "training_organisation": {
      "type": "string",
      "description": "the registered training organisation that assessed it",
      "x-demiton-requiredness": "optional"
    }
  },
  "x-demiton-register-type": "certification_register",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "General construction induction training card (White Card)",
        "title": "Australian general construction induction card scheme",
        "access": "public_summary",
        "region": "Australia",
        "edition": "current",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Model Work Health and Safety Regulations Schedule 3",
        "title": "High risk work licence classes (reg 81 and Schedule 3)",
        "access": "full_text_verified",
        "clause": "reg 81; Schedule 3",
        "region": "Australia",
        "edition": "model regs as amended 5 Dec 2025",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 1988 (Cth)",
        "title": "Privacy Act 1988 - Australian Privacy Principles; employee-records exemption; health information s.6FA",
        "access": "public_summary",
        "region": "Australia",
        "edition": "current",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Regulation (EU) 2016/679 (GDPR)",
        "title": "General Data Protection Regulation",
        "access": "full_text_verified",
        "region": "European Union",
        "edition": "2016",
        "checked_on": "2026-09-14"
      },
      {
        "code": "ISO 45001:2018",
        "title": "Occupational health and safety management systems - Requirements with guidance for use",
        "access": "paywalled_secondary",
        "clause": "7.2",
        "region": "International",
        "edition": "2018 + Amd 1:2024",
        "checked_on": "2026-09-14"
      },
      {
        "code": "CSCS card scheme",
        "title": "Construction Skills Certification Scheme (non-statutory)",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "current",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Worker credentials and their expiry, as safety and site-access systems hold them.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/certification_register/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}