{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/user_list/v1.json",
  "title": "user_list contract v1",
  "type": "object",
  "required": [
    "display_name",
    "source_external_id",
    "worker_entity_id"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address used as the cross-source identity bridge",
      "x-demiton-requiredness": "optional"
    },
    "phone": {
      "type": "string",
      "description": "Contact phone number",
      "x-demiton-requiredness": "optional"
    },
    "job_title": {
      "type": "string",
      "description": "Role/job title in the owning organisation",
      "x-demiton-requiredness": "optional"
    },
    "department": {
      "type": "string",
      "description": "Organisational unit the account belongs to",
      "x-demiton-requiredness": "optional"
    },
    "display_name": {
      "type": "string",
      "description": "The person's display name",
      "x-demiton-requiredness": "required"
    },
    "identity_kind": {
      "type": "string",
      "description": "The source's own classification of the account, where it exposes one",
      "x-demiton-requiredness": "optional"
    },
    "work_location": {
      "type": "string",
      "description": "Location associated with the account (city/site/suburb)",
      "x-demiton-requiredness": "optional"
    },
    "account_enabled": {
      "type": "boolean",
      "description": "Whether the source account is currently enabled/active",
      "x-demiton-requiredness": "optional"
    },
    "worker_entity_id": {
      "type": "integer",
      "description": "Demiton canonical worker spine node this fact anchors to (the subject)",
      "x-demiton-requiredness": "required"
    },
    "source_created_at": {
      "type": "string",
      "description": "When the source record was created (freshness)",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "source_external_id": {
      "type": "string",
      "description": "The raw record id in the producing system, scoped to `source_system`",
      "x-demiton-requiredness": "required"
    },
    "user_principal_name": {
      "type": "string",
      "description": "Directory sign-in name (Entra UPN)",
      "x-demiton-requiredness": "optional"
    }
  },
  "x-demiton-register-type": "user_list",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "Fair Work Regulations 2009 (Cth)",
        "title": "Fair Work Regulations 2009 - employee record content",
        "access": "full_text_verified",
        "clause": "reg 3.32",
        "region": "Australia",
        "edition": "compilation 2026-06-20",
        "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": "Single Touch Payroll Phase 2 (ATO)",
        "title": "Single Touch Payroll Phase 2 employer reporting guidelines",
        "access": "public_summary",
        "region": "Australia",
        "edition": "Phase 2 (mandatory from 1 Jan 2022)",
        "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 30414:2025",
        "title": "Human resource management - Requirements and recommendations for human capital reporting and disclosure",
        "access": "paywalled_secondary",
        "region": "International",
        "edition": "2nd ed. 2025 (supersedes ISO 30414:2018)",
        "checked_on": "2026-09-14"
      },
      {
        "code": "Privacy Act 2020 (NZ)",
        "title": "Privacy Act 2020 and Health Information Privacy Code 2020",
        "access": "public_summary",
        "region": "New Zealand",
        "edition": "Act 2020; HIPC version as at 1 May 2026",
        "checked_on": "2026-09-14"
      },
      {
        "code": "UK GDPR",
        "title": "UK GDPR and Data Protection Act 2018",
        "access": "public_summary",
        "region": "United Kingdom",
        "edition": "current",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Users in your identity directory and operational systems.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/user_list/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}