{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.demiton.io/registers/permit_to_work/v1.json",
  "title": "permit_to_work contract v1",
  "type": "object",
  "required": [
    "external_id",
    "permit_type",
    "project",
    "reference",
    "status"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "the permit's title",
      "x-demiton-requiredness": "optional"
    },
    "zone": {
      "type": "string",
      "description": "the permit zone on site",
      "x-demiton-requiredness": "optional"
    },
    "status": {
      "type": "string",
      "description": "where the permit is in its lifecycle",
      "x-demiton-requiredness": "required"
    },
    "project": {
      "type": "string",
      "description": "the site or project the permit is for",
      "x-demiton-requiredness": "required",
      "x-demiton-reference": true
    },
    "approver": {
      "type": "string",
      "description": "who approved the permit",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "employer": {
      "type": "string",
      "description": "the employer doing the permitted work",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "location": {
      "type": "string",
      "description": "where the work is, as free text",
      "x-demiton-requiredness": "optional"
    },
    "initiator": {
      "type": "string",
      "description": "who created the permit record",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "raised_at": {
      "type": "string",
      "description": "when the permit was initiated",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "reference": {
      "type": "string",
      "description": "the permit's human reference",
      "x-demiton-requiredness": "required"
    },
    "requester": {
      "type": "string",
      "description": "who asked for the permit",
      "x-demiton-requiredness": "optional",
      "x-demiton-reference": true
    },
    "actual_end": {
      "type": "string",
      "description": "when the work actually finished",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "approved_at": {
      "type": "string",
      "description": "when the permit was approved",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "external_id": {
      "type": "string",
      "description": "the source system's own permit id",
      "x-demiton-requiredness": "required"
    },
    "permit_type": {
      "type": "string",
      "description": "the kind of hazardous work permitted",
      "x-demiton-requiredness": "required"
    },
    "actual_start": {
      "type": "string",
      "description": "when the work actually started",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "proposed_end": {
      "type": "string",
      "description": "when the work was planned to finish",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "closed_out_at": {
      "type": "string",
      "description": "when the permit was closed out",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "proposed_start": {
      "type": "string",
      "description": "when the work was planned to start",
      "x-demiton-requiredness": "optional",
      "format": "date-time",
      "x-demiton-type": "datetime"
    },
    "closeout_checklist_completed": {
      "type": "boolean",
      "description": "whether the closeout checklist was done",
      "x-demiton-requiredness": "optional"
    }
  },
  "x-demiton-register-type": "permit_to_work",
  "x-demiton-contract-version": "1.0.3",
  "x-demiton-store": "tenant",
  "x-demiton-axes": [],
  "x-demiton-measures": [],
  "x-demiton-provenance": {
    "standards": [
      {
        "code": "AS/NZS ISO 45001:2018",
        "title": "Occupational health and safety management systems - Requirements with guidance for use",
        "access": "paywalled_secondary",
        "clause": "8.1.2",
        "region": "Australia",
        "edition": "2018 (Amd 1:2024 listing)",
        "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": "8.1.2 eliminating hazards and reducing OH&S risks",
        "region": "International",
        "edition": "2018 (Amd 1:2024)",
        "checked_on": "2026-09-14"
      }
    ]
  },
  "description": "Permits controlling hazardous work.",
  "x-demiton-contract-url": "https://docs.demiton.io/registers/permit_to_work/",
  "x-demiton-register-catalog": "https://docs.demiton.io/concepts/register-catalog"
}