@planning-inspectorate/data-model 2.9.0 → 2.10.1

package/docs/appeal-s78.md

@@ -53,9 +53,9 @@ any of
 | [caseDecisionOutcome](#casedecisionoutcome)                                                     | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-casedecisionoutcome.md "appeal-s78.schema.json#/properties/caseDecisionOutcome")                                                     |
 | [caseCompletedDate](#casecompleteddate)                                                         | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-casecompleteddate.md "appeal-s78.schema.json#/properties/caseCompletedDate")                                                         |
 | [enforcementNotice](#enforcementnotice)                                                         | `boolean` | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-enforcementnotice.md "appeal-s78.schema.json#/properties/enforcementNotice")                                                         |
-| [applicationReference](#applicationreference)                                                   | `string`  | Required | cannot be null | [Appeal S78 Case](appeal-s78-properties-applicationreference.md "appeal-s78.schema.json#/properties/applicationReference")                                                   |
-| [applicationDate](#applicationdate)                                                             | `string`  | Required | cannot be null | [Appeal S78 Case](appeal-s78-properties-applicationdate.md "appeal-s78.schema.json#/properties/applicationDate")                                                             |
-| [applicationDecision](#applicationdecision)                                                     | `string`  | Required | cannot be null | [Appeal S78 Case](appeal-s78-properties-applicationdecision.md "appeal-s78.schema.json#/properties/applicationDecision")                                                     |
+| [applicationReference](#applicationreference)                                                   | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationreference.md "appeal-s78.schema.json#/properties/applicationReference")                                                   |
+| [applicationDate](#applicationdate)                                                             | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationdate.md "appeal-s78.schema.json#/properties/applicationDate")                                                             |
+| [applicationDecision](#applicationdecision)                                                     | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationdecision.md "appeal-s78.schema.json#/properties/applicationDecision")                                                     |
 | [applicationDecisionDate](#applicationdecisiondate)                                             | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationdecisiondate.md "appeal-s78.schema.json#/properties/applicationDecisionDate")                                             |
 | [caseSubmissionDueDate](#casesubmissionduedate)                                                 | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-casesubmissionduedate.md "appeal-s78.schema.json#/properties/caseSubmissionDueDate")                                                 |
 | [siteAddressLine1](#siteaddressline1)                                                           | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-siteaddressline1.md "appeal-s78.schema.json#/properties/siteAddressLine1")                                                           |
@@ -156,6 +156,9 @@ any of
 | [isSiteInAreaOfSpecialControlAdverts](#issiteinareaofspecialcontroladverts)                     | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-issiteinareaofspecialcontroladverts.md "appeal-s78.schema.json#/properties/isSiteInAreaOfSpecialControlAdverts")                     |
 | [advertDetails](#advertdetails)                                                                 | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-advertdetails.md "appeal-s78.schema.json#/properties/advertDetails")                                                                 |
 | [padsSapId](#padssapid)                                                                         | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-padssapid.md "appeal-s78.schema.json#/properties/padsSapId")                                                                         |
+| [enforcementNoticeReference](#enforcementnoticereference)                                       | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-enforcementnoticereference.md "appeal-s78.schema.json#/properties/enforcementNoticeReference")                                       |
+| [descriptionOfAllegedBreach](#descriptionofallegedbreach)                                       | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-descriptionofallegedbreach.md "appeal-s78.schema.json#/properties/descriptionOfAllegedBreach")                                       |
+| [dateAppellantContactedPins](#dateappellantcontactedpins)                                       | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-dateappellantcontactedpins.md "appeal-s78.schema.json#/properties/dateAppellantContactedPins")                                       |
 | [ownerOccupancyStatus](#owneroccupancystatus)                                                   | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-owneroccupancystatus.md "appeal-s78.schema.json#/properties/ownerOccupancyStatus")                                                   |
 | [occupancyConditionsMet](#occupancyconditionsmet)                                               | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-occupancyconditionsmet.md "appeal-s78.schema.json#/properties/occupancyConditionsMet")                                               |
 | [enforcementAppealGroundsDetails](#enforcementappealgroundsdetails)                             | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-enforcementappealgroundsdetails.md "appeal-s78.schema.json#/properties/enforcementAppealGroundsDetails")                             |
@@ -1398,7 +1401,7 @@ The unique identifier of the LPA application
 
 * Type: `string`
 
-* cannot be null
+* can be null
 
 * defined in: [Appeal S78 Case](appeal-s78-properties-applicationreference.md "appeal-s78.schema.json#/properties/applicationReference")
 
@@ -1424,7 +1427,7 @@ The date of the original LPA application
 
 * Type: `string`
 
-* cannot be null
+* can be null
 
 * defined in: [Appeal S78 Case](appeal-s78-properties-applicationdate.md "appeal-s78.schema.json#/properties/applicationDate")
 
@@ -1454,7 +1457,7 @@ The outcome of the original LPA decision
 
 * Type: `string`
 
-* cannot be null
+* can be null
 
 * defined in: [Appeal S78 Case](appeal-s78-properties-applicationdecision.md "appeal-s78.schema.json#/properties/applicationDecision")
 
@@ -3776,6 +3779,84 @@ padsSapId for PADS inspectors
 
 `string`
 
+## enforcementNoticeReference
+
+The reference number of the enforcement notice
+
+`enforcementNoticeReference`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-enforcementnoticereference.md "appeal-s78.schema.json#/properties/enforcementNoticeReference")
+
+### enforcementNoticeReference Type
+
+`string`
+
+### enforcementNoticeReference Examples
+
+```json
+"myC45e-123"
+```
+
+## descriptionOfAllegedBreach
+
+A description of the alleged breach
+
+`descriptionOfAllegedBreach`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-descriptionofallegedbreach.md "appeal-s78.schema.json#/properties/descriptionOfAllegedBreach")
+
+### descriptionOfAllegedBreach Type
+
+`string`
+
+### descriptionOfAllegedBreach Examples
+
+```json
+"My breach description"
+```
+
+## dateAppellantContactedPins
+
+The date of the appellant contacted PINS prior to submitting an appeal
+
+> Relevant if enforcement effective date already passed
+
+`dateAppellantContactedPins`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-dateappellantcontactedpins.md "appeal-s78.schema.json#/properties/dateAppellantContactedPins")
+
+### dateAppellantContactedPins Type
+
+`string`
+
+### dateAppellantContactedPins Constraints
+
+**date time**: the string must be a date time string, according to [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339 "check the specification")
+
+### dateAppellantContactedPins Examples
+
+```json
+"2025-12-26T10:00:00.000Z"
+```
+
 ## ownerOccupancyStatus
 
 The nature of the appellant's interest in the appeal site

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "2.9.0",
+  "version": "2.10.1",
   "description": "JSON Schemas for the Planning Inspectorate's Data Model",
   "main": "src/index.js",
   "type": "module",

package/pins_data_model/models/model_appeal_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-document.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_event_estimate.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event-estimate.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_has.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-has.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-representation.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_appeal_s78.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-s78.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 
@@ -579,11 +579,13 @@ class AppealS78Case1(BaseModel):
     """
     Indicates if an enforcement notice is the reason for the appeal
     """
-    applicationReference: str = Field(..., examples=["43010/APP/1/290572"])
+    applicationReference: str | None = Field(..., examples=["43010/APP/1/290572"])
     """
     The unique identifier of the LPA application
     """
-    applicationDate: AwareDatetime = Field(..., examples=["2023-07-27T20:30:00.000Z"])
+    applicationDate: AwareDatetime | None = Field(
+        ..., examples=["2023-07-27T20:30:00.000Z"]
+    )
     """
     The date of the original LPA application
     """
@@ -962,6 +964,22 @@ class AppealS78Case1(BaseModel):
     """
     padsSapId for PADS inspectors
     """
+    enforcementNoticeReference: str | None = Field(None, examples=["myC45e-123"])
+    """
+    The reference number of the enforcement notice
+    """
+    descriptionOfAllegedBreach: str | None = Field(
+        None, examples=["My breach description"]
+    )
+    """
+    A description of the alleged breach
+    """
+    dateAppellantContactedPins: AwareDatetime | None = Field(
+        None, examples=["2025-12-26T10:00:00.000Z"]
+    )
+    """
+    The date of the appellant contacted PINS prior to submitting an appeal
+    """
     ownerOccupancyStatus: str | None = Field(
         None, examples=["Owner", "Tenant", "Mortgage lender"]
     )
@@ -1287,11 +1305,13 @@ class AppealS78Case2(BaseModel):
     """
     Indicates if an enforcement notice is the reason for the appeal
     """
-    applicationReference: str = Field(..., examples=["43010/APP/1/290572"])
+    applicationReference: str | None = Field(..., examples=["43010/APP/1/290572"])
     """
     The unique identifier of the LPA application
     """
-    applicationDate: AwareDatetime = Field(..., examples=["2023-07-27T20:30:00.000Z"])
+    applicationDate: AwareDatetime | None = Field(
+        ..., examples=["2023-07-27T20:30:00.000Z"]
+    )
     """
     The date of the original LPA application
     """
@@ -1670,6 +1690,22 @@ class AppealS78Case2(BaseModel):
     """
     padsSapId for PADS inspectors
     """
+    enforcementNoticeReference: str | None = Field(None, examples=["myC45e-123"])
+    """
+    The reference number of the enforcement notice
+    """
+    descriptionOfAllegedBreach: str | None = Field(
+        None, examples=["My breach description"]
+    )
+    """
+    A description of the alleged breach
+    """
+    dateAppellantContactedPins: AwareDatetime | None = Field(
+        None, examples=["2025-12-26T10:00:00.000Z"]
+    )
+    """
+    The date of the appellant contacted PINS prior to submitting an appeal
+    """
     ownerOccupancyStatus: str | None = Field(
         None, examples=["Owner", "Tenant", "Mortgage lender"]
     )

package/pins_data_model/models/model_dart_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  dart-response.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_entraid.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  entraid.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_folder.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  folder.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_gettimesheets_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  gettimesheets-response.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_building.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-building.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_listed_buildings.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  listed-buildings.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_document.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-document.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_exam_timetable.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-exam-timetable.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_invoice.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-invoice.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_meeting.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-meeting.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_project.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_project_update.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-project-update.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_representation.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-representation.schema.json
-#   timestamp: 2026-01-12T14:59:51+00:00
+#   timestamp: 2026-01-16T12:29:57+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_nsip_subscription.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  nsip-subscription.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_pins_inspector.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pins-inspector.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_pins_lpa.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  pins-lpa.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_s51_advice.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  s51-advice.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/pins_data_model/models/model_service_user.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  service-user.schema.json
-#   timestamp: 2026-01-12T14:59:50+00:00
+#   timestamp: 2026-01-16T12:29:56+00:00
 
 from __future__ import annotations
 

package/schemas/appeal-s78.schema.json

@@ -464,20 +464,20 @@
       "$comment": "Also available on HAS cases"
     },
     "applicationReference": {
-      "type": "string",
+      "type": ["string", "null"],
       "examples": ["43010/APP/1/290572"],
       "description": "The unique identifier of the LPA application",
       "$comment": "Also available on HAS cases"
     },
     "applicationDate": {
-      "type": "string",
+      "type": ["string", "null"],
       "format": "date-time",
       "examples": ["2023-07-27T20:30:00.000Z"],
       "description": "The date of the original LPA application",
       "$comment": "Also available on HAS cases"
     },
     "applicationDecision": {
-      "type": "string",
+      "type": ["string", "null"],
       "enum": ["granted", "refused", "not_received"],
       "description": "The outcome of the original LPA decision",
       "$comment": "Also available on HAS cases"
@@ -1107,6 +1107,23 @@
       "type": ["string", "null"],
       "description": "padsSapId for PADS inspectors"
     },
+    "enforcementNoticeReference": {
+      "type": ["string", "null"],
+      "description": "The reference number of the enforcement notice",
+      "examples": ["myC45e-123"]
+    },
+    "descriptionOfAllegedBreach": {
+      "type": ["string", "null"],
+      "description": "A description of the alleged breach",
+      "examples": ["My breach description"]
+    },
+    "dateAppellantContactedPins": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2025-12-26T10:00:00.000Z"],
+      "description": "The date of the appellant contacted PINS prior to submitting an appeal",
+      "$comment": "Relevant if enforcement effective date already passed"
+    },
     "ownerOccupancyStatus": {
       "type": ["string", "null"],
       "description": "The nature of the appellant's interest in the appeal site",

package/schemas/commands/appeals-components/appeal-s78-submission.schema.json

@@ -23,54 +23,44 @@
       "properties": {
         "agriculturalHolding": {
           "type": ["boolean", "null"],
-          "description": "Indicates if the site is an agricultural holding",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates if the site is an agricultural holding"
         },
         "tenantAgriculturalHolding": {
           "type": ["boolean", "null"],
-          "description": "Indicates if the site is a tenant agricultural holding",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates if the site is a tenant agricultural holding"
         },
         "otherTenantsAgriculturalHolding": {
           "type": ["boolean", "null"],
-          "description": "Indicates if the site is an agricultural holding with other tenants",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates if the site is an agricultural holding with other tenants"
         },
         "informedTenantsAgriculturalHolding": {
           "type": ["boolean", "null"],
-          "description": "If the site is an agricultural holding, indicates tenants are informed",
-          "$comment": "Only available in S78 cases"
+          "description": "If the site is an agricultural holding, indicates tenants are informed"
         },
         "appellantProcedurePreference": {
           "type": ["string", "null"],
           "enum": ["written", "hearing", "inquiry", null],
-          "description": "The procedure preference indicated by the appellant",
-          "$comment": "Only available in S78 cases"
+          "description": "The procedure preference indicated by the appellant"
         },
         "appellantProcedurePreferenceDetails": {
           "type": ["string", "null"],
-          "description": "The procedure details preference indicated by the appellant",
-          "$comment": "Only available in S78 cases"
+          "description": "The procedure details preference indicated by the appellant"
         },
         "appellantProcedurePreferenceDuration": {
           "type": ["number", "null"],
-          "description": "The duration of the procedure indicated by the appellant",
-          "$comment": "Only available in S78 cases"
+          "description": "The duration of the procedure indicated by the appellant"
         },
         "appellantProcedurePreferenceWitnessCount": {
           "type": ["number", "null"],
-          "description": "The number of witnesses in inquiries",
-          "$comment": "Only available in S78 cases"
+          "description": "The number of witnesses in inquiries"
         },
         "planningObligation": {
           "type": ["boolean", "null"],
-          "description": "Indicates the existence of a planning obligation",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates the existence of a planning obligation"
         },
         "statusPlanningObligation": {
           "type": ["string", "null"],
-          "description": "The planning obligation information, if available",
-          "$comment": "Only available in S78 cases"
+          "description": "The planning obligation information, if available"
         },
         "developmentType": {
           "type": ["string", "null"],

package/schemas/commands/appeals-components/lpa-questionnaire-listed-building.schema.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/lpa-questionnaire-listed-building.schema.json",
+  "title": "LPAQ listed building submission properties",
+  "description": "Schema defining any listed building specific properties for LPAQ submissions",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["preserveGrantLoan", "consultHistoricEngland"],
+  "allOf": [
+    {
+      "properties": {
+        "preserveGrantLoan": {
+          "type": ["boolean", "null"],
+          "description": "A grant or loan has been made to preserve the listed building"
+        },
+        "consultHistoricEngland": {
+          "type": ["boolean", "null"],
+          "description": "Are Historic England to be consulted?"
+        }
+      }
+    }
+  ]
+}

package/schemas/commands/appeals-components/lpa-questionnaire-s78.schema.json

@@ -19,23 +19,19 @@
       "properties": {
         "affectsScheduledMonument": {
           "type": ["boolean", "null"],
-          "description": "Indicates that a scheduled monument is affected",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates that a scheduled monument is affected"
         },
         "hasTreePreservationOrder": {
           "type": ["boolean", "null"],
-          "description": "Indicates a TPO (tree preservation order)",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates a TPO (tree preservation order)"
         },
         "isPublicRightOfWay": {
           "type": ["boolean", "null"],
-          "description": "Indicates a PROW (public right of way)",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates a PROW (public right of way)"
         },
         "hasStatutoryConsultees": {
           "type": ["boolean", "null"],
-          "description": "Indicates statutory consultees",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates statutory consultees"
         },
         "consultedBodiesDetails": {
           "type": ["string", "null"],
@@ -43,18 +39,15 @@
         },
         "hasConsultationResponses": {
           "type": ["boolean", "null"],
-          "description": "Indicates consultation responses",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates consultation responses"
         },
         "hasEmergingPlan": {
           "type": ["boolean", "null"],
-          "description": "Indicates emerging plans",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates emerging plans"
         },
         "hasSupplementaryPlanningDocs": {
           "type": ["boolean", "null"],
-          "description": "Indicates supplementary planning documents",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates supplementary planning documents"
         }
       }
     }

package/schemas/commands/appeals-components/{site-designations-protections.schema.json → site-designations-protection.schema.json}

@@ -17,18 +17,15 @@
       "properties": {
         "affectsScheduledMonument": {
           "type": ["boolean", "null"],
-          "description": "Indicates that a scheduled monument is affected",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates that a scheduled monument is affected"
         },
         "hasProtectedSpecies": {
           "type": ["boolean", "null"],
-          "description": "Indicates the existence of protected species",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates the existence of protected species"
         },
         "isAonbNationalLandscape": {
           "type": ["boolean", "null"],
-          "description": "Indicates an area of outstanding beauty (National Landscape)",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates an area of outstanding beauty (National Landscape)"
         },
         "designatedSitesNames": {
           "type": ["array", "null"],
@@ -36,13 +33,11 @@
             "type": "string",
             "examples": ["SSSI", "cSAC", "SAC", "pSPA", "SPA", "user entered value"]
           },
-          "description": "The designated site names",
-          "$comment": "Only available in S78 cases"
+          "description": "The designated site names"
         },
         "isGypsyOrTravellerSite": {
           "type": ["boolean", "null"],
-          "description": "Indicates a traveller site",
-          "$comment": "Only available in S78 cases"
+          "description": "Indicates a traveller site"
         }
       }
     }

package/schemas/commands/lpa-questionnaire.schema.json

@@ -21,9 +21,9 @@
           ]
         },
         {
-          "$comment": "S78 + S20",
+          "$comment": "S78",
           "allOf": [
-            { "properties": { "caseType": { "enum": ["W", "Y"] } } },
+            { "properties": { "caseType": { "enum": ["W"] } } },
             { "$ref": "appeals-components/lpa-questionnaire-common.schema.json" },
             { "$ref": "appeals-components/lpa-questionnaire-has.schema.json" },
             { "$ref": "appeals-components/lpa-questionnaire-s78.schema.json" },
@@ -34,14 +34,29 @@
             { "$ref": "appeals-components/site-designations-protection.schema.json" }
           ]
         },
+        {
+          "$comment": "S20",
+          "allOf": [
+            { "properties": { "caseType": { "enum": ["Y"] } } },
+            { "$ref": "appeals-components/lpa-questionnaire-common.schema.json" },
+            { "$ref": "appeals-components/lpa-questionnaire-has.schema.json" },
+            { "$ref": "appeals-components/lpa-questionnaire-s78.schema.json" },
+            { "$ref": "appeals-components/lpa-procedure-preference.schema.json" },
+            { "$ref": "appeals-components/changed-listed-building-number.schema.json" },
+            { "$ref": "appeals-components/infrastructure-levy.schema.json" },
+            { "$ref": "appeals-components/environmental-impact-assessment.schema.json" },
+            { "$ref": "appeals-components/site-designations-protection.schema.json" },
+            { "$ref": "appeals-components/lpa-questionnaire-listed-building.schema.json" }
+          ]
+        },
         {
           "$comment": "CAS Adverts",
           "allOf": [
             { "properties": { "caseType": { "enum": ["ZA"] } } },
             { "$ref": "appeals-components/lpa-questionnaire-common.schema.json" },
             { "$ref": "appeals-components/lpa-questionnaire-has.schema.json" },
-            { "$ref": "appeals-components/lpa-procedure-preference.schema.json" },
-            { "$ref": "appeals-components/lpa-questionnaire-advert.schema.json" }
+            { "$ref": "appeals-components/lpa-questionnaire-advert.schema.json" },
+            { "$ref": "appeals-components/lpa-procedure-preference.schema.json" }
           ]
         },
         {
@@ -119,6 +134,7 @@
           "documentType": {
             "type": ["string", "null"],
             "enum": [
+              null,
               "whoNotified",
               "whoNotifiedSiteNotice",
               "whoNotifiedLetterToNeighbours",
@@ -135,7 +151,6 @@
               "supplementaryPlanning",
               "emergingPlan",
               "appealNotification",
-              null,
               "otherRelevantPolicies",
               "treePreservationPlan",
               "consultationResponses",

package/src/schemas.d.ts

@@ -145,6 +145,9 @@ export interface AppealDocument {
     | 'environmentalAssessment'
     | 'appealNotification'
     | 'historicEnglandConsultation'
+    | 'conservationDocuments'
+    | 'planShowingExtentOfOrder'
+    | 'definitiveMapAndStatementExtract'
     | 'stopNotice'
     | 'article4Direction'
     | 'enforcementList'
@@ -153,6 +156,18 @@ export interface AppealDocument {
     | 'lpaEnforcementNotice'
     | 'lpaEnforcementNoticePlan'
     | 'planningContraventionNotice'
+    | 'priorCorrespondenceWithPINS'
+    | 'enforcementNotice'
+    | 'enforcementNoticePlan'
+    | 'groundASupporting'
+    | 'groundBSupporting'
+    | 'groundCSupporting'
+    | 'groundDSupporting'
+    | 'groundESupporting'
+    | 'groundFSupporting'
+    | 'groundGSupporting'
+    | 'groundAFeeReceipt'
+    | 'delegatedReport'
     | null;
   /**
    * The system mastering the metadata for the current document
@@ -1107,15 +1122,15 @@ export type AppealS78Case = (
   /**
    * The unique identifier of the LPA application
    */
-  applicationReference: string;
+  applicationReference: string | null;
   /**
    * The date of the original LPA application
    */
-  applicationDate: string;
+  applicationDate: string | null;
   /**
    * The outcome of the original LPA decision
    */
-  applicationDecision: 'granted' | 'refused' | 'not_received';
+  applicationDecision: ('granted' | 'refused' | 'not_received') | null;
   /**
    * The date of the original LPA decision
    */
@@ -1531,6 +1546,18 @@ export type AppealS78Case = (
    * padsSapId for PADS inspectors
    */
   padsSapId?: string | null;
+  /**
+   * The reference number of the enforcement notice
+   */
+  enforcementNoticeReference?: string | null;
+  /**
+   * A description of the alleged breach
+   */
+  descriptionOfAllegedBreach?: string | null;
+  /**
+   * The date of the appellant contacted PINS prior to submitting an appeal
+   */
+  dateAppellantContactedPins?: string | null;
   /**
    * The nature of the appellant's interest in the appeal site
    */
@@ -4058,7 +4085,7 @@ export interface AppellantSubmissionCommand {
       | 'groundISupporting'
       | 'groundJSupporting'
       | 'groundKSupporting'
-      | 'applicationFeeReceipt'
+      | 'groundAFeeReceipt'
       | null
       | 'environmentalAssessment';
     [k: string]: unknown;
@@ -4394,6 +4421,19 @@ export type SiteDesignationsAndProtectionSpecificProperties = {
    */
   isGypsyOrTravellerSite?: boolean | null;
 };
+/**
+ * Schema defining any listed building specific properties for LPAQ submissions
+ */
+export type LPAQListedBuildingSubmissionProperties = {
+  /**
+   * A grant or loan has been made to preserve the listed building
+   */
+  preserveGrantLoan?: boolean | null;
+  /**
+   * Are Historic England to be consulted?
+   */
+  consultHistoricEngland?: boolean | null;
+};
 /**
  * Schema defining any advert specific properties for LPAQ submissions
  */
@@ -4477,7 +4517,7 @@ export interface LPAQuestionnaireCommand {
       } & LPAQCommonSubmissionProperties &
         LPAQHASSubmissionProperties)
     | ({
-        caseType?: 'W' | 'Y';
+        caseType?: 'W';
       } & LPAQCommonSubmissionProperties &
         LPAQHASSubmissionProperties &
         LPAQS78SubmissionProperties &
@@ -4487,11 +4527,22 @@ export interface LPAQuestionnaireCommand {
         EnvironmentalImpactAssessmentProperties &
         SiteDesignationsAndProtectionSpecificProperties)
     | ({
-        caseType?: 'ZA';
+        caseType?: 'Y';
       } & LPAQCommonSubmissionProperties &
         LPAQHASSubmissionProperties &
+        LPAQS78SubmissionProperties &
         LPAProcedurePreferenceProperties &
-        LPAQCasAdvertSubmissionProperties)
+        ChangedListedBuildingNumbersProperties &
+        InfrastructureLevyProperties &
+        EnvironmentalImpactAssessmentProperties &
+        SiteDesignationsAndProtectionSpecificProperties &
+        LPAQListedBuildingSubmissionProperties)
+    | ({
+        caseType?: 'ZA';
+      } & LPAQCommonSubmissionProperties &
+        LPAQHASSubmissionProperties &
+        LPAQCasAdvertSubmissionProperties &
+        LPAProcedurePreferenceProperties)
     | ({
         caseType?: 'H';
       } & LPAQCommonSubmissionProperties &
@@ -4542,6 +4593,7 @@ export interface LPAQuestionnaireCommand {
      * The type of document, used for exchange, migrations and consumption from the appeal back-office system
      */
     documentType:
+      | null
       | 'whoNotified'
       | 'whoNotifiedSiteNotice'
       | 'whoNotifiedLetterToNeighbours'
@@ -4558,7 +4610,6 @@ export interface LPAQuestionnaireCommand {
       | 'supplementaryPlanning'
       | 'emergingPlan'
       | 'appealNotification'
-      | null
       | 'otherRelevantPolicies'
       | 'treePreservationPlan'
       | 'consultationResponses'
@@ -4574,8 +4625,8 @@ export interface LPAQuestionnaireCommand {
       | 'enforcementList'
       | 'localDevelopmentOrder'
       | 'planningPermission'
-      | 'enforcementNotice'
-      | 'enforcementNoticePlan'
+      | 'lpaEnforcementNotice'
+      | 'lpaEnforcementNoticePlan'
       | 'planningContraventionNotice';
     [k: string]: unknown;
   }[];

package/tests/appeals/commands/s20-questionnaire.test.js

@@ -0,0 +1,108 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import { loadAllSchemasSync } from '../../../src/index.js';
+
+const schema = 'lpa-questionnaire.schema.json';
+
+const document = {
+	documentId: 'deserunt sint aliqua adipisicing dolore',
+	filename: 'ut dolore',
+	originalFilename: 'Lorem amet fugiat adipisicing Excepteur',
+	size: -90476934,
+	mime: 'magna labore exercitation ut',
+	documentURI: 'ut reprehenderit',
+	dateCreated: '1933-04-03T03:24:38.0Z',
+	documentType: 'plansDrawings'
+};
+
+const exampleS20QuestionnaireSchema = {
+	casedata: {
+		caseType: 'Y',
+		caseReference: 'est ea elit in nulla',
+		lpaQuestionnaireSubmittedDate: '2026-01-01T12:00:00.000Z',
+		siteAccessDetails: ['velit adipisicing fugiat dolor ullamco'],
+		siteSafetyDetails: ['ut', 'dolore ut sint Duis', 'magna consequat quis laboris officia'],
+		nearbyCaseReferences: ['nulla', 'incididunt eu nostrud eiusmod', 'exercitation', 'Ut nostrud', 'eiusmod cillum eu'],
+		neighbouringSiteAddresses: [
+			{
+				neighbouringSiteAddressLine1: '123 High Street',
+				neighbouringSiteAddressLine2: 'Second line of address of the site',
+				neighbouringSiteAddressTown: 'Maidstone',
+				neighbouringSiteAddressCounty: 'Kent',
+				neighbouringSiteAddressPostcode: 'MD21 5XY',
+				neighbouringSiteAccessDetails: 'Ongoing road works at this address',
+				neighbouringSiteSafetyDetails: 'Ongoing road works at this address'
+			}
+		],
+		isCorrectAppealType: true,
+		affectedListedBuildingNumbers: ['12345', '67890'],
+		isGreenBelt: true,
+		inConservationArea: true,
+		newConditionDetails: 'Test',
+		notificationMethod: ['irure', 'cillum tempor incididunt labore in'],
+		lpaCostsAppliedFor: true,
+		lpaStatement: 'ex laborum cupidatat',
+		changedListedBuildingNumbers: ['54321', '09876'],
+		affectsScheduledMonument: true,
+		hasProtectedSpecies: true,
+		isAonbNationalLandscape: true,
+		designatedSitesNames: ['quis nulla eu officia exercitation'],
+		hasTreePreservationOrder: true,
+		isGypsyOrTravellerSite: true,
+		isPublicRightOfWay: true,
+		eiaEnvironmentalImpactSchedule: 'schedule-2',
+		eiaDevelopmentDescription: 'production-processing-of-metals',
+		eiaSensitiveAreaDetails: 'test',
+		eiaColumnTwoThreshold: true,
+		eiaScreeningOpinion: true,
+		eiaRequiresEnvironmentalStatement: true,
+		eiaCompletedEnvironmentalStatement: true,
+		hasStatutoryConsultees: true,
+		consultedBodiesDetails: 'in in labore irure nostrud',
+		hasConsultationResponses: true,
+		hasEmergingPlan: true,
+		hasSupplementaryPlanningDocs: true,
+		hasInfrastructureLevy: true,
+		isInfrastructureLevyFormallyAdopted: true,
+		infrastructureLevyAdoptedDate: '1913-06-14T10:40:33.0Z',
+		infrastructureLevyExpectedDate: '1912-06-14T10:40:33.0Z',
+		lpaProcedurePreference: 'written',
+		lpaProcedurePreferenceDetails: 'in reprehenderit',
+		lpaProcedurePreferenceDuration: -34480053.16630782,
+		preserveGrantLoan: true,
+		consultHistoricEngland: true
+	},
+	documents: [document]
+};
+
+describe('S20 questionnaire command schema', () => {
+	const schemas = loadAllSchemasSync();
+	const flatSchemas = Object.values(schemas).reduce((a, c) => ({ ...a, ...c }), {});
+	const ajv = new Ajv({ schemas: flatSchemas, allErrors: true });
+	addFormats(ajv);
+
+	it('should allow valid schema for S20', () => {
+		const validationResult = ajv.validate(schema, exampleS20QuestionnaireSchema);
+		assert.strictEqual(validationResult, true);
+	});
+
+	it('should reject missing caseReference', () => {
+		const test = structuredClone(exampleS20QuestionnaireSchema);
+		delete test.casedata.caseReference;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, false);
+		assert.strictEqual(
+			ajv.errors.some((x) => x.message === "must have required property 'caseReference'"),
+			true
+		);
+	});
+
+	it('should allow additional props', () => {
+		const test = structuredClone(exampleS20QuestionnaireSchema);
+		test.test = 1;
+		const validationResult = ajv.validate(schema, test);
+		assert.strictEqual(validationResult, true);
+	});
+});

package/tests/appeals/commands/s78-questionnaire.test.js

@@ -21,44 +21,54 @@ const exampleS78QuestionnaireSchema = {
 	casedata: {
 		caseType: 'W',
 		caseReference: 'est ea elit in nulla',
-		lpaQuestionnaireSubmittedDate: null,
+		lpaQuestionnaireSubmittedDate: '2026-01-01T12:00:00.000Z',
 		siteAccessDetails: ['velit adipisicing fugiat dolor ullamco'],
 		siteSafetyDetails: ['ut', 'dolore ut sint Duis', 'magna consequat quis laboris officia'],
 		nearbyCaseReferences: ['nulla', 'incididunt eu nostrud eiusmod', 'exercitation', 'Ut nostrud', 'eiusmod cillum eu'],
-		neighbouringSiteAddresses: null,
+		neighbouringSiteAddresses: [
+			{
+				neighbouringSiteAddressLine1: '123 High Street',
+				neighbouringSiteAddressLine2: 'Second line of address of the site',
+				neighbouringSiteAddressTown: 'Maidstone',
+				neighbouringSiteAddressCounty: 'Kent',
+				neighbouringSiteAddressPostcode: 'MD21 5XY',
+				neighbouringSiteAccessDetails: 'Ongoing road works at this address',
+				neighbouringSiteSafetyDetails: 'Ongoing road works at this address'
+			}
+		],
 		isCorrectAppealType: true,
-		affectedListedBuildingNumbers: null,
-		isGreenBelt: null,
-		inConservationArea: null,
-		newConditionDetails: null,
+		affectedListedBuildingNumbers: ['12345', '67890'],
+		isGreenBelt: true,
+		inConservationArea: true,
+		newConditionDetails: 'Test',
 		notificationMethod: ['irure', 'cillum tempor incididunt labore in'],
 		lpaCostsAppliedFor: true,
 		lpaStatement: 'ex laborum cupidatat',
-		changedListedBuildingNumbers: null,
+		changedListedBuildingNumbers: ['54321', '09876'],
 		affectsScheduledMonument: true,
-		hasProtectedSpecies: false,
+		hasProtectedSpecies: true,
 		isAonbNationalLandscape: true,
 		designatedSitesNames: ['quis nulla eu officia exercitation'],
-		hasTreePreservationOrder: null,
+		hasTreePreservationOrder: true,
 		isGypsyOrTravellerSite: true,
-		isPublicRightOfWay: null,
+		isPublicRightOfWay: true,
 		eiaEnvironmentalImpactSchedule: 'schedule-2',
 		eiaDevelopmentDescription: 'production-processing-of-metals',
-		eiaSensitiveAreaDetails: null,
-		eiaColumnTwoThreshold: false,
-		eiaScreeningOpinion: false,
-		eiaRequiresEnvironmentalStatement: null,
+		eiaSensitiveAreaDetails: 'test',
+		eiaColumnTwoThreshold: true,
+		eiaScreeningOpinion: true,
+		eiaRequiresEnvironmentalStatement: true,
 		eiaCompletedEnvironmentalStatement: true,
 		hasStatutoryConsultees: true,
 		consultedBodiesDetails: 'in in labore irure nostrud',
-		hasConsultationResponses: null,
-		hasEmergingPlan: null,
-		hasSupplementaryPlanningDocs: null,
+		hasConsultationResponses: true,
+		hasEmergingPlan: true,
+		hasSupplementaryPlanningDocs: true,
 		hasInfrastructureLevy: true,
-		isInfrastructureLevyFormallyAdopted: false,
+		isInfrastructureLevyFormallyAdopted: true,
 		infrastructureLevyAdoptedDate: '1913-06-14T10:40:33.0Z',
 		infrastructureLevyExpectedDate: '1912-06-14T10:40:33.0Z',
-		lpaProcedurePreference: null,
+		lpaProcedurePreference: 'written',
 		lpaProcedurePreferenceDetails: 'in reprehenderit',
 		lpaProcedurePreferenceDuration: -34480053.16630782
 	},
@@ -76,13 +86,6 @@ describe('S78 questionnaire command schema', () => {
 		assert.strictEqual(validationResult, true);
 	});
 
-	it('should allow valid schema for S20', () => {
-		const test = structuredClone(exampleS78QuestionnaireSchema);
-		test.casedata.caseType = 'Y';
-		const validationResult = ajv.validate(schema, test);
-		assert.strictEqual(validationResult, true);
-	});
-
 	it('should reject missing caseReference', () => {
 		const test = structuredClone(exampleS78QuestionnaireSchema);
 		delete test.casedata.caseReference;