@planning-inspectorate/data-model 2.10.2 → 2.11.0

package/docs/appeal-document.md

@@ -620,6 +620,8 @@ The type of document, used for exchange, migrations and consumption from the app
 | `"groundGSupporting"`                |             |
 | `"groundAFeeReceipt"`                |             |
 | `"delegatedReport"`                  |             |
+| `"relatedApplications"`              |             |
+| `"otherRelevantMatters"`             |             |
 | `null`                               |             |
 
 ## sourceSystem

package/docs/appeal-has.md

@@ -2462,6 +2462,7 @@ Indicates if the appellant has applied for costs
 | `"listed-building"`                    |             |
 | `"minor-commercial-development"`       |             |
 | `"advertisement"`                      |             |
+| `"lawful-development-certificate"`     |             |
 | `null`                                 |             |
 
 ## siteGridReferenceEasting

package/docs/appeal-s78.md

@@ -191,6 +191,11 @@ any of
 | [isSiteSubjectToArticle4Direction](#issitesubjecttoarticle4direction)                           | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-issitesubjecttoarticle4direction.md "appeal-s78.schema.json#/properties/isSiteSubjectToArticle4Direction")                           |
 | [article4AffectedDevelopmentRights](#article4affecteddevelopmentrights)                         | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-article4affecteddevelopmentrights.md "appeal-s78.schema.json#/properties/article4AffectedDevelopmentRights")                         |
 | [pcnRestrictedDevelopmentRights](#pcnrestricteddevelopmentrights)                               | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-pcnrestricteddevelopmentrights.md "appeal-s78.schema.json#/properties/pcnRestrictedDevelopmentRights")                               |
+| [applicationMadeUnderActSection](#applicationmadeunderactsection)                               | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-applicationmadeunderactsection.md "appeal-s78.schema.json#/properties/applicationMadeUnderActSection")                               |
+| [siteUseAtTimeOfApplication](#siteuseattimeofapplication)                                       | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-siteuseattimeofapplication.md "appeal-s78.schema.json#/properties/siteUseAtTimeOfApplication")                                       |
+| [appealUnderActSection](#appealunderactsection)                                                 | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-appealunderactsection.md "appeal-s78.schema.json#/properties/appealUnderActSection")                                                 |
+| [lpaConsiderAppealInvalid](#lpaconsiderappealinvalid)                                           | `boolean` | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-lpaconsiderappealinvalid.md "appeal-s78.schema.json#/properties/lpaConsiderAppealInvalid")                                           |
+| [lpaAppealInvalidReasons](#lpaappealinvalidreasons)                                             | `string`  | Optional | can be null    | [Appeal S78 Case](appeal-s78-properties-lpaappealinvalidreasons.md "appeal-s78.schema.json#/properties/lpaAppealInvalidReasons")                                             |
 | Additional Properties                                                                           | Any       | Optional | can be null    |                                                                                                                                                                              |
 
 ## caseId
@@ -3571,6 +3576,7 @@ The net gain in residences of the proposed development
 | `"listed-building"`                    |             |
 | `"minor-commercial-development"`       |             |
 | `"advertisement"`                      |             |
+| `"lawful-development-certificate"`     |             |
 | `null`                                 |             |
 
 ## developmentType
@@ -4512,6 +4518,118 @@ Have any development rights been restricted by means of a planning condition?
 
 `boolean`
 
+## applicationMadeUnderActSection
+
+
+
+`applicationMadeUnderActSection`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-applicationmadeunderactsection.md "appeal-s78.schema.json#/properties/applicationMadeUnderActSection")
+
+### applicationMadeUnderActSection Type
+
+`string`
+
+### applicationMadeUnderActSection Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value                                     | Explanation |
+| :---------------------------------------- | :---------- |
+| `"existing-development"`                  |             |
+| `"proposed-use-of-a-development"`         |             |
+| `"proposed-changes-to-a-listed-building"` |             |
+| `null`                                    |             |
+
+## siteUseAtTimeOfApplication
+
+Site use at time of application
+
+`siteUseAtTimeOfApplication`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-siteuseattimeofapplication.md "appeal-s78.schema.json#/properties/siteUseAtTimeOfApplication")
+
+### siteUseAtTimeOfApplication Type
+
+`string`
+
+## appealUnderActSection
+
+
+
+`appealUnderActSection`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-appealunderactsection.md "appeal-s78.schema.json#/properties/appealUnderActSection")
+
+### appealUnderActSection Type
+
+`string`
+
+### appealUnderActSection Constraints
+
+**enum**: the value of this property must be equal to one of the following values:
+
+| Value                                     | Explanation |
+| :---------------------------------------- | :---------- |
+| `"existing-development"`                  |             |
+| `"proposed-use-of-a-development"`         |             |
+| `"proposed-changes-to-a-listed-building"` |             |
+| `null`                                    |             |
+
+## lpaConsiderAppealInvalid
+
+
+
+`lpaConsiderAppealInvalid`
+
+* is optional
+
+* Type: `boolean`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-lpaconsiderappealinvalid.md "appeal-s78.schema.json#/properties/lpaConsiderAppealInvalid")
+
+### lpaConsiderAppealInvalid Type
+
+`boolean`
+
+## lpaAppealInvalidReasons
+
+Reason(s) why LPA consider the appeal invalid
+
+`lpaAppealInvalidReasons`
+
+* is optional
+
+* Type: `string`
+
+* can be null
+
+* defined in: [Appeal S78 Case](appeal-s78-properties-lpaappealinvalidreasons.md "appeal-s78.schema.json#/properties/lpaAppealInvalidReasons")
+
+### lpaAppealInvalidReasons Type
+
+`string`
+
 ## Additional Properties
 
 Additional properties are allowed and do not have to follow a specific schema

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planning-inspectorate/data-model",
-  "version": "2.10.2",
+  "version": "2.11.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-01-20T11:57:10+00:00
+#   timestamp: 2026-01-21T12:30:03+00:00
 
 from __future__ import annotations
 
@@ -142,6 +142,8 @@ class DocumentType(Enum):
     groundGSupporting = "groundGSupporting"
     groundAFeeReceipt = "groundAFeeReceipt"
     delegatedReport = "delegatedReport"
+    relatedApplications = "relatedApplications"
+    otherRelevantMatters = "otherRelevantMatters"
     NoneType_None = None
 
 

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-20T11:57:10+00:00
+#   timestamp: 2026-01-21T12:30:03+00:00
 
 from __future__ import annotations
 
@@ -229,6 +229,7 @@ class TypeOfPlanningApplication(Enum):
     listed_building = "listed-building"
     minor_commercial_development = "minor-commercial-development"
     advertisement = "advertisement"
+    lawful_development_certificate = "lawful-development-certificate"
     NoneType_None = None
 
 

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-20T11:57:10+00:00
+#   timestamp: 2026-01-21T12:30:03+00:00
 
 from __future__ import annotations
 
@@ -281,6 +281,7 @@ class TypeOfPlanningApplication(Enum):
     listed_building = "listed-building"
     minor_commercial_development = "minor-commercial-development"
     advertisement = "advertisement"
+    lawful_development_certificate = "lawful-development-certificate"
     NoneType_None = None
 
 
@@ -370,6 +371,20 @@ class ApplicationPartOrWholeDevelopment(Enum):
     NoneType_None = None
 
 
+class ApplicationMadeUnderActSection(Enum):
+    existing_development = "existing-development"
+    proposed_use_of_a_development = "proposed-use-of-a-development"
+    proposed_changes_to_a_listed_building = "proposed-changes-to-a-listed-building"
+    NoneType_None = None
+
+
+class AppealUnderActSection(Enum):
+    existing_development = "existing-development"
+    proposed_use_of_a_development = "proposed-use-of-a-development"
+    proposed_changes_to_a_listed_building = "proposed-changes-to-a-listed-building"
+    NoneType_None = None
+
+
 class AppealS78Case1(BaseModel):
     """
     Group B - Schema defining the metadata for an appeal
@@ -1065,6 +1080,17 @@ class AppealS78Case1(BaseModel):
     """
     Have any development rights been restricted by means of a planning condition?
     """
+    applicationMadeUnderActSection: ApplicationMadeUnderActSection | None = None
+    siteUseAtTimeOfApplication: str | None = None
+    """
+    Site use at time of application
+    """
+    appealUnderActSection: AppealUnderActSection | None = None
+    lpaConsiderAppealInvalid: bool | None = None
+    lpaAppealInvalidReasons: str | None = None
+    """
+    Reason(s) why LPA consider the appeal invalid
+    """
 
 
 class AdvertDetail1(BaseModel):
@@ -1791,6 +1817,17 @@ class AppealS78Case2(BaseModel):
     """
     Have any development rights been restricted by means of a planning condition?
     """
+    applicationMadeUnderActSection: ApplicationMadeUnderActSection | None = None
+    siteUseAtTimeOfApplication: str | None = None
+    """
+    Site use at time of application
+    """
+    appealUnderActSection: AppealUnderActSection | None = None
+    lpaConsiderAppealInvalid: bool | None = None
+    lpaAppealInvalidReasons: str | None = None
+    """
+    Reason(s) why LPA consider the appeal invalid
+    """
 
 
 class AppealS78Case(RootModel[AppealS78Case1 | AppealS78Case2]):

package/schemas/appeal-document.schema.json

@@ -220,6 +220,8 @@
         "groundGSupporting",
         "groundAFeeReceipt",
         "delegatedReport",
+        "relatedApplications",
+        "otherRelevantMatters",
         null
       ],
       "description": "The type of document, used for exchange, migrations and consumption from the appeal back-office system"

package/schemas/appeal-has.schema.json

@@ -696,6 +696,7 @@
         "listed-building",
         "minor-commercial-development",
         "advertisement",
+        "lawful-development-certificate",
         null
       ]
     },

package/schemas/appeal-s78.schema.json

@@ -1014,6 +1014,7 @@
         "listed-building",
         "minor-commercial-development",
         "advertisement",
+        "lawful-development-certificate",
         null
       ]
     },
@@ -1265,6 +1266,25 @@
     "pcnRestrictedDevelopmentRights": {
       "type": ["boolean", "null"],
       "description": "Have any development rights been restricted by means of a planning condition?"
+    },
+    "applicationMadeUnderActSection": {
+      "type": ["string", "null"],
+      "enum": ["existing-development", "proposed-use-of-a-development", "proposed-changes-to-a-listed-building", null]
+    },
+    "siteUseAtTimeOfApplication": {
+      "type": ["string", "null"],
+      "description": "Site use at time of application"
+    },
+    "appealUnderActSection": {
+      "type": ["string", "null"],
+      "enum": ["existing-development", "proposed-use-of-a-development", "proposed-changes-to-a-listed-building", null]
+    },
+    "lpaConsiderAppealInvalid": {
+      "type": ["boolean", "null"]
+    },
+    "lpaAppealInvalidReasons": {
+      "type": ["string", "null"],
+      "description": "Reason(s) why LPA consider the appeal invalid"
     }
   }
 }

package/schemas/commands/appeals-components/appeal-common-planning.schema.json

@@ -0,0 +1,54 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/appeal-common-planning.schema.json",
+  "title": "Appellant common planning properties",
+  "description": "Schema defining any properties common across all planning appeal types for appeal submissions",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "applicationReference",
+    "applicationDate",
+    "applicationDecision",
+    "applicationDecisionDate",
+    "isGreenBelt",
+    "originalDevelopmentDescription",
+    "changedDevelopmentDescription"
+  ],
+  "properties": {
+    "applicationReference": {
+      "type": "string",
+      "examples": ["43010/APP/1/290572"],
+      "description": "The unique identifier of the LPA application"
+    },
+    "applicationDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date of the original LPA application"
+    },
+    "applicationDecision": {
+      "type": ["string", "null"],
+      "enum": ["granted", "refused", "not_received", null],
+      "description": "The outcome of the original LPA decision"
+    },
+    "applicationDecisionDate": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "examples": ["2023-07-27T20:30:00.000Z"],
+      "description": "The date of the original LPA decision"
+    },
+    "isGreenBelt": {
+      "type": ["boolean", "null"],
+      "description": "Indicates if the site is in a green belt"
+    },
+    "originalDevelopmentDescription": {
+      "type": ["string", "null"],
+      "examples": ["Replacement of an existing gate to access the property"],
+      "description": "The original description of the development, as provided by the appellant"
+    },
+    "changedDevelopmentDescription": {
+      "type": ["boolean", "null"],
+      "description": "Indicates that the LPA has changed the development description"
+    }
+  }
+}

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

@@ -11,15 +11,11 @@
     "lpaCode",
     "caseSubmittedDate",
     "enforcementNotice",
-    "applicationReference",
-    "applicationDate",
-    "applicationDecision",
-    "applicationDecisionDate",
     "caseSubmissionDueDate",
     "siteAccessDetails",
     "siteSafetyDetails",
-    "neighbouringSiteAddresses",
-    "nearbyCaseReferences"
+    "nearbyCaseReferences",
+    "appellantCostsAppliedFor"
   ],
   "anyOf": [
     {
@@ -66,28 +62,6 @@
       "type": ["boolean", "null"],
       "description": "Indicates if an enforcement notice is the reason for the appeal"
     },
-    "applicationReference": {
-      "type": "string",
-      "examples": ["43010/APP/1/290572"],
-      "description": "The unique identifier of the LPA application"
-    },
-    "applicationDate": {
-      "type": "string",
-      "format": "date-time",
-      "examples": ["2023-07-27T20:30:00.000Z"],
-      "description": "The date of the original LPA application"
-    },
-    "applicationDecision": {
-      "type": "string",
-      "enum": ["granted", "refused", "not_received"],
-      "description": "The outcome of the original LPA decision"
-    },
-    "applicationDecisionDate": {
-      "type": ["string", "null"],
-      "format": "date-time",
-      "examples": ["2023-07-27T20:30:00.000Z"],
-      "description": "The date of the original LPA decision"
-    },
     "caseSubmissionDueDate": {
       "type": ["string", "null"],
       "format": "date-time",
@@ -145,59 +119,6 @@
       },
       "description": "Provided information on site health and safety"
     },
-    "neighbouringSiteAddresses": {
-      "type": ["array", "null"],
-      "items": {
-        "type": "object",
-        "additionalProperties": true,
-        "properties": {
-          "neighbouringSiteAddressLine1": {
-            "type": "string",
-            "examples": ["96 The Avenue"],
-            "description": "First line of address of the site"
-          },
-          "neighbouringSiteAddressLine2": {
-            "type": ["string", "null"],
-            "description": "Second line of address of the site"
-          },
-          "neighbouringSiteAddressTown": {
-            "type": "string",
-            "examples": ["Maidstone"],
-            "description": "Town / City of the site address"
-          },
-          "neighbouringSiteAddressCounty": {
-            "type": ["string", "null"],
-            "examples": ["Kent"],
-            "description": "County of the site address"
-          },
-          "neighbouringSiteAddressPostcode": {
-            "type": "string",
-            "examples": ["MD21 5XY"],
-            "description": "Postal code of the site address"
-          },
-          "neighbouringSiteAccessDetails": {
-            "type": ["string", "null"],
-            "examples": ["Ongoing road works at this address"],
-            "description": "Provided information on site accessibility on this address"
-          },
-          "neighbouringSiteSafetyDetails": {
-            "type": ["string", "null"],
-            "examples": ["Ongoing road works at this address"],
-            "description": "Provided information on site health and safety on this address"
-          }
-        },
-        "required": [
-          "neighbouringSiteAddressLine1",
-          "neighbouringSiteAddressLine2",
-          "neighbouringSiteAddressTown",
-          "neighbouringSiteAddressCounty",
-          "neighbouringSiteAddressPostcode",
-          "neighbouringSiteAccessDetails",
-          "neighbouringSiteSafetyDetails"
-        ]
-      },
-      "description": "A list of neighbouring site addresses"
-    },
     "nearbyCaseReferences": {
       "type": ["array", "null"],
       "items": {
@@ -218,8 +139,13 @@
         "listed-building",
         "minor-commercial-development",
         "advertisement",
+        "lawful-development-certificate",
         null
       ]
+    },
+    "appellantCostsAppliedFor": {
+      "type": ["boolean", "null"],
+      "description": "Indicates if the appellant has applied for costs"
     }
   }
 }

package/schemas/commands/appeals-components/appeal-land-ownership.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/appeal-land-ownership.schema.json",
+  "title": "Appeal land ownership properties",
+  "description": "Schema defining properties relating to land ownership",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "ownsAllLand",
+    "ownsSomeLand",
+    "knowsOtherOwners",
+    "knowsAllOwners",
+    "advertisedAppeal",
+    "ownersInformed"
+  ],
+  "allOf": [
+    {
+      "properties": {
+        "ownsAllLand": {
+          "type": ["boolean", "null"],
+          "description": "Indicates if the appellant has complete ownership of the site"
+        },
+        "ownsSomeLand": {
+          "type": ["boolean", "null"],
+          "description": "Indicates if the appellant has partial ownership of the site"
+        },
+        "knowsOtherOwners": {
+          "type": ["string", "null"],
+          "enum": ["Yes", "No", "Some", null],
+          "description": "Indicates if the appellant knows other owners of the site"
+        },
+        "knowsAllOwners": {
+          "type": ["string", "null"],
+          "enum": ["Yes", "No", "Some", null],
+          "description": "Indicates if the appellant knows all owners of the site"
+        },
+        "advertisedAppeal": {
+          "type": ["boolean", "null"],
+          "description": "Indicates if the appellant has advertised the appeal to the LPA decision"
+        },
+        "ownersInformed": {
+          "type": ["boolean", "null"],
+          "description": "Indicates if the appellant has informed other owners of the site"
+        }
+      }
+    }
+  ]
+}

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

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/appeal-ldc.submission.schema.json",
+  "title": "LDC specific properties",
+  "description": "Schema defining any properties for ldc appeals",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["siteUseAtTimeOfApplication", "applicationMadeUnderActSection"],
+  "properties": {
+    "siteUseAtTimeOfApplication": {
+      "type": ["string", "null"],
+      "description": "Site use at time of application"
+    },
+    "applicationMadeUnderActSection": {
+      "type": ["string", "null"],
+      "enum": ["existing-development", "proposed-use-of-a-development", "proposed-changes-to-a-listed-building", null]
+    }
+  }
+}

package/schemas/commands/appeals-components/appeal-site-area.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/appeal-site-area.schema.json",
+  "title": "Site area properties",
+  "description": "Schema defining any properties for site area for an appeal",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["siteAreaSquareMetres", "floorSpaceSquareMetres"],
+  "properties": {
+    "siteAreaSquareMetres": {
+      "type": ["number", "null"],
+      "examples": [45.7],
+      "description": "The site area, in square meters"
+    },
+    "floorSpaceSquareMetres": {
+      "type": ["number", "null"],
+      "examples": [3.5],
+      "description": "The floor space, in square meters"
+    }
+  }
+}

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

@@ -11,7 +11,8 @@
     "siteAccessDetails",
     "siteSafetyDetails",
     "nearbyCaseReferences",
-    "neighbouringSiteAddresses"
+    "neighbouringSiteAddresses",
+    "isCorrectAppealType"
   ],
   "properties": {
     "caseReference": {
@@ -105,6 +106,10 @@
     "reasonForNeighbourVisits": {
       "type": ["string", "null"],
       "description": "A general reason given for the need to visit any neighbours"
+    },
+    "isCorrectAppealType": {
+      "type": ["boolean", "null"],
+      "description": "Indicates if the LPA considers the appeal type appropriate"
     }
   }
 }

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

@@ -6,7 +6,6 @@
   "type": "object",
   "additionalProperties": true,
   "required": [
-    "isCorrectAppealType",
     "affectedListedBuildingNumbers",
     "isGreenBelt",
     "inConservationArea",
@@ -18,10 +17,6 @@
   "allOf": [
     {
       "properties": {
-        "isCorrectAppealType": {
-          "type": ["boolean", "null"],
-          "description": "Indicates if the LPA considers the appeal type appropriate"
-        },
         "affectedListedBuildingNumbers": {
           "type": ["array", "null"],
           "items": {

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

@@ -0,0 +1,31 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "commands/appeals-components/lpa-questionnaire-ldc.schema.json",
+  "title": "LPAQ LDC submission properties",
+  "description": "Schema defining any LDC specific properties for LPAQ submissions",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["appealUnderActSection", "lpaConsiderAppealInvalid", "lpaAppealInvalidReasons"],
+  "allOf": [
+    {
+      "properties": {
+        "appealUnderActSection": {
+          "type": ["string", "null"],
+          "enum": [
+            "existing-development",
+            "proposed-use-of-a-development",
+            "proposed-changes-to-a-listed-building",
+            null
+          ]
+        },
+        "lpaConsiderAppealInvalid": {
+          "type": ["boolean", "null"]
+        },
+        "lpaAppealInvalidReasons": {
+          "type": ["string", "null"],
+          "description": "Reason(s) why LPA consider the appeal invalid"
+        }
+      }
+    }
+  ]
+}