@planning-inspectorate/data-model 2.18.0 → 2.20.0

package/docs/README.md

@@ -64,6 +64,8 @@
 
 * [Untitled object in Appeal S78 Case](./appeal-s78-properties-enforcementappealgroundsdetails-items.md) – `appeal-s78.schema.json#/properties/enforcementAppealGroundsDetails/items`
 
+* [Untitled object in Appeal S78 Case](./appeal-s78-properties-applicationelbappealgroundsdetails-items.md) – `appeal-s78.schema.json#/properties/applicationElbAppealGroundsDetails/items`
+
 * [Untitled object in DaRT API response](./dart-response-properties-neighbouringsiteaddresses-items.md) – `dart-response.schema.json#/properties/neighbouringSiteAddresses/items`
 
 * [Untitled object in Examination Timetable](./nsip-exam-timetable-defs-event.md) – `nsip-exam-timetable.schema.json#/$defs/event`

package/docs/appeal-document.md

@@ -622,6 +622,10 @@ The type of document, used for exchange, migrations and consumption from the app
 | `"delegatedReport"`                  |             |
 | `"relatedApplications"`              |             |
 | `"otherRelevantMatters"`             |             |
+| `"groundHSupporting"`                |             |
+| `"groundISupporting"`                |             |
+| `"groundJSupporting"`                |             |
+| `"groundKSupporting"`                |             |
 | `null`                               |             |
 
 ## sourceSystem

package/docs/appeal-s78.md

@@ -80,6 +80,7 @@ any of
 | [originalDevelopmentDescription](#originaldevelopmentdescription)                               | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-originaldevelopmentdescription.md "appeal-s78.schema.json#/properties/originalDevelopmentDescription")                               |
 | [changedDevelopmentDescription](#changeddevelopmentdescription)                                 | `boolean` | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-changeddevelopmentdescription.md "appeal-s78.schema.json#/properties/changedDevelopmentDescription")                                 |
 | [newConditionDetails](#newconditiondetails)                                                     | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-newconditiondetails.md "appeal-s78.schema.json#/properties/newConditionDetails")                                                     |
+| [extraConditionsDetails](#extraconditionsdetails)                                               | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-extraconditionsdetails.md "appeal-s78.schema.json#/properties/extraConditionsDetails")                                               |
 | [nearbyCaseReferences](#nearbycasereferences)                                                   | `array`   | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-nearbycasereferences.md "appeal-s78.schema.json#/properties/nearbyCaseReferences")                                                   |
 | [neighbouringSiteAddresses](#neighbouringsiteaddresses)                                         | `array`   | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-neighbouringsiteaddresses.md "appeal-s78.schema.json#/properties/neighbouringSiteAddresses")                                         |
 | [reasonForNeighbourVisits](#reasonforneighbourvisits)                                           | `string`  | Required | can be null    | [Appeal S78 Case](appeal-s78-properties-reasonforneighbourvisits.md "appeal-s78.schema.json#/properties/reasonForNeighbourVisits")                                           |
@@ -162,6 +163,7 @@ any of
 | [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")                             |
+| [applicationElbAppealGroundsDetails](#applicationelbappealgroundsdetails)                       | `array`   | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationelbappealgroundsdetails.md "appeal-s78.schema.json#/properties/applicationElbAppealGroundsDetails")                       |
 | [applicationMadeAndFeePaid](#applicationmadeandfeepaid)                                         | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationmadeandfeepaid.md "appeal-s78.schema.json#/properties/applicationMadeAndFeePaid")                                         |
 | [noticeRelatesToBuildingEngineeringMiningOther](#noticerelatestobuildingengineeringminingother) | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-noticerelatestobuildingengineeringminingother.md "appeal-s78.schema.json#/properties/noticeRelatesToBuildingEngineeringMiningOther") |
 | [changeOfUseRefuseOrWaste](#changeofuserefuseorwaste)                                           | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-changeofuserefuseorwaste.md "appeal-s78.schema.json#/properties/changeOfUseRefuseOrWaste")                                           |
@@ -2067,6 +2069,30 @@ New conditions details provided by the LPA
 "Since the original application, a number of things have changed..."
 ```
 
+## extraConditionsDetails
+
+extra conditions details provided by the LPA
+
+`extraConditionsDetails`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-extraconditionsdetails.md "appeal-s78.schema.json#/properties/extraConditionsDetails")
+
+### extraConditionsDetails Type
+
+`string`
+
+### extraConditionsDetails Examples
+
+```json
+"Since the original application, a number of things have changed..."
+```
+
 ## nearbyCaseReferences
 
 A list of related case references known to the appellant and the LPA
@@ -3935,6 +3961,26 @@ A list of grounds for the appeal, supporting facts & start dates. Enforcement ca
 
 `object[]` ([Details](appeal-s78-properties-enforcementappealgroundsdetails-items.md))
 
+## applicationElbAppealGroundsDetails
+
+A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)
+
+> Enforcement Listed Building cases (F) have a separate list of grounds (a) to (k)
+
+`applicationElbAppealGroundsDetails`
+
+* is optional
+
+* Type: `object[]` ([Details](appeal-s78-properties-applicationelbappealgroundsdetails-items.md))
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-applicationelbappealgroundsdetails.md "appeal-s78.schema.json#/properties/applicationElbAppealGroundsDetails")
+
+### applicationElbAppealGroundsDetails Type
+
+`object[]` ([Details](appeal-s78-properties-applicationelbappealgroundsdetails-items.md))
+
 ## applicationMadeAndFeePaid
 
 Was an application made and paid for

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "2.18.0",
+  "version": "2.20.0",
   "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-02-06T12:26:23+00:00
+#   timestamp: 2026-02-09T10:43:16+00:00
 
 from __future__ import annotations
 
@@ -144,6 +144,10 @@ class DocumentType(Enum):
     delegatedReport = "delegatedReport"
     relatedApplications = "relatedApplications"
     otherRelevantMatters = "otherRelevantMatters"
+    groundHSupporting = "groundHSupporting"
+    groundISupporting = "groundISupporting"
+    groundJSupporting = "groundJSupporting"
+    groundKSupporting = "groundKSupporting"
     NoneType_None = None
 
 

package/pins_data_model/models/model_appeal_event.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  appeal-event.schema.json
-#   timestamp: 2026-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:23+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+00:00
 
 from __future__ import annotations
 
@@ -362,6 +362,35 @@ class EnforcementAppealGroundsDetail(BaseModel):
     """
 
 
+class AppealGroundLetter1(Enum):
+    a = "a"
+    b = "b"
+    c = "c"
+    d = "d"
+    e = "e"
+    f = "f"
+    g = "g"
+    h = "h"
+    i = "i"
+    j = "j"
+    k = "k"
+    NoneType_None = None
+
+
+class ApplicationElbAppealGroundsDetail(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    appealGroundLetter: AppealGroundLetter1 | None = None
+    groundForAppealStartDate: AwareDatetime | None = Field(
+        None, examples=["2023-07-27T20:30:00.000Z"]
+    )
+    groundFacts: str | None = None
+    """
+    Facts supporting the appeal ground
+    """
+
+
 class ApplicationPartOrWholeDevelopment(Enum):
     """
     Did the application relate to all or part of the development
@@ -717,6 +746,13 @@ class AppealS78Case1(BaseModel):
     """
     New conditions details provided by the LPA
     """
+    extraConditionsDetails: str | None = Field(
+        None,
+        examples=["Since the original application, a number of things have changed..."],
+    )
+    """
+    extra conditions details provided by the LPA
+    """
     nearbyCaseReferences: list[str]
     """
     A list of related case references known to the appellant and the LPA
@@ -1011,6 +1047,12 @@ class AppealS78Case1(BaseModel):
     """
     A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)
     """
+    applicationElbAppealGroundsDetails: (
+        list[ApplicationElbAppealGroundsDetail] | None
+    ) = None
+    """
+    A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)
+    """
     applicationMadeAndFeePaid: bool | None = None
     """
     Was an application made and paid for
@@ -1109,11 +1151,51 @@ class AdvertDetail1(BaseModel):
     """
 
 
+class AppealGroundLetter2(Enum):
+    a = "a"
+    b = "b"
+    c = "c"
+    d = "d"
+    e = "e"
+    f = "f"
+    g = "g"
+    NoneType_None = None
+
+
 class EnforcementAppealGroundsDetail1(BaseModel):
     model_config = ConfigDict(
         extra="allow",
     )
-    appealGroundLetter: AppealGroundLetter | None = None
+    appealGroundLetter: AppealGroundLetter2 | None = None
+    groundForAppealStartDate: AwareDatetime | None = Field(
+        None, examples=["2023-07-27T20:30:00.000Z"]
+    )
+    groundFacts: str | None = None
+    """
+    Facts supporting the appeal ground
+    """
+
+
+class AppealGroundLetter3(Enum):
+    a = "a"
+    b = "b"
+    c = "c"
+    d = "d"
+    e = "e"
+    f = "f"
+    g = "g"
+    h = "h"
+    i = "i"
+    j = "j"
+    k = "k"
+    NoneType_None = None
+
+
+class ApplicationElbAppealGroundsDetail1(BaseModel):
+    model_config = ConfigDict(
+        extra="allow",
+    )
+    appealGroundLetter: AppealGroundLetter3 | None = None
     groundForAppealStartDate: AwareDatetime | None = Field(
         None, examples=["2023-07-27T20:30:00.000Z"]
     )
@@ -1454,6 +1536,13 @@ class AppealS78Case2(BaseModel):
     """
     New conditions details provided by the LPA
     """
+    extraConditionsDetails: str | None = Field(
+        None,
+        examples=["Since the original application, a number of things have changed..."],
+    )
+    """
+    extra conditions details provided by the LPA
+    """
     nearbyCaseReferences: list[str]
     """
     A list of related case references known to the appellant and the LPA
@@ -1748,6 +1837,12 @@ class AppealS78Case2(BaseModel):
     """
     A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)
     """
+    applicationElbAppealGroundsDetails: (
+        list[ApplicationElbAppealGroundsDetail1] | None
+    ) = None
+    """
+    A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)
+    """
     applicationMadeAndFeePaid: bool | None = None
     """
     Was an application made and paid for

package/pins_data_model/models/model_dart_response.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  dart-response.schema.json
-#   timestamp: 2026-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:24+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+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-02-06T12:26:25+00:00
+#   timestamp: 2026-02-09T10:43:16+00:00
 
 from __future__ import annotations
 

package/schemas/appeal-document.schema.json

@@ -222,6 +222,10 @@
         "delegatedReport",
         "relatedApplications",
         "otherRelevantMatters",
+        "groundHSupporting",
+        "groundISupporting",
+        "groundJSupporting",
+        "groundKSupporting",
         null
       ],
       "description": "The type of document, used for exchange, migrations and consumption from the appeal back-office system"

package/schemas/appeal-s78.schema.json

@@ -629,6 +629,11 @@
       "description": "New conditions details provided by the LPA",
       "$comment": "Also available on HAS cases"
     },
+    "extraConditionsDetails": {
+      "type": ["string", "null"],
+      "examples": ["Since the original application, a number of things have changed..."],
+      "description": "extra conditions details provided by the LPA"
+    },
     "nearbyCaseReferences": {
       "type": ["array", "null"],
       "items": {
@@ -1158,6 +1163,30 @@
       "description": "A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)",
       "$comment": "Enforcement Listed Building cases (F) have a separate list of grounds (a) to (k)"
     },
+    "applicationElbAppealGroundsDetails": {
+      "type": ["array", "null"],
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "properties": {
+          "appealGroundLetter": {
+            "type": ["string", "null"],
+            "enum": ["a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", null]
+          },
+          "groundForAppealStartDate": {
+            "type": ["string", "null"],
+            "format": "date-time",
+            "examples": ["2023-07-27T20:30:00.000Z"]
+          },
+          "groundFacts": {
+            "type": ["string", "null"],
+            "description": "Facts supporting the appeal ground"
+          }
+        }
+      },
+      "description": "A list of grounds for the appeal, supporting facts & start dates. Enforcement cases (C) can have grounds (a) to (g)",
+      "$comment": "Enforcement Listed Building cases (F) have a separate list of grounds (a) to (k)"
+    },
     "applicationMadeAndFeePaid": {
       "type": ["boolean", "null"],
       "description": "Was an application made and paid for"