@pdtf/schemas 3.6.0-dev.3 → 3.6.0-dev.30

package/src/schemas/v3/pdtf-transaction.json

@@ -36,6 +36,56 @@
         }
       }
     },
+    "metadata": {
+      "title": "Metadata",
+      "description": "Flexible container for vendor-specific metadata items relating to the transaction. Keys are vendor-defined; values may be strings, numbers, booleans or nested objects. Paths are addressable up to three levels below /metadata (e.g. /metadata/vendor/item/field).",
+      "type": "object",
+      "patternProperties": {
+        ".*": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "number"
+            },
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "object",
+              "patternProperties": {
+                ".*": {
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "array"
+                    },
+                    {
+                      "type": "null"
+                    },
+                    {
+                      "type": "object",
+                      "patternProperties": {
+                        ".*": {}
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          ]
+        }
+      }
+    },
     "status": {
       "type": "string",
       "enum": [
@@ -183,6 +233,29 @@
             "title": "Reference",
             "type": "string"
           },
+          "did": {
+            "title": "Participant DID",
+            "description": "Decentralised Identifier for this party - the primary way to identify them. Unlike participantId it is global and stable: the same person carries the same DID across transactions, and across two entries in one transaction where they are both buying and selling. Minted when the party is created, so it should always be present.",
+            "type": "string",
+            "pattern": "^did:[a-z0-9]+:(?:(?:[a-zA-Z0-9._-]|%[0-9A-Fa-f]{2})*:)*(?:[a-zA-Z0-9._-]|%[0-9A-Fa-f]{2})+$"
+          },
+          "participantId": {
+            "title": "Participant id",
+            "description": "Transaction-local identifier for this participant, for implementations that do not mint DIDs. Prefer did. Referencing by array position is unsafe because participants may be added or removed.",
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+          },
+          "actingFor": {
+            "title": "Acting for",
+            "description": "The parties this participant is instructed by, for example the sellers a conveyancer acts for, identified by their did or - where no DID is minted - their participantId. One entry per represented party: a conveyancer instructed jointly by two sellers lists both, and sellers who instruct separate conveyancers appear as separate representatives each acting for one of them. A conveyancer is instructed by a person, not by an offer - the offer link is participants[].offerId.",
+            "type": "array",
+            "items": {
+              "title": "Represented party",
+              "description": "did, or participantId, of a party this participant is instructed by",
+              "type": "string",
+              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+            }
+          },
           "role": {
             "title": "Role",
             "type": "string",
@@ -192,6 +265,7 @@
               "Prospective Buyer",
               "Buyer",
               "Buyer's Conveyancer",
+              "Giftor",
               "Estate Agent",
               "Buyer's Agent",
               "Surveyor",
@@ -517,6 +591,10 @@
                         "title": "Company number",
                         "type": "string"
                       },
+                      "directorOrAuthorisedPerson": {
+                        "title": "Director/authorised person",
+                        "type": "string"
+                      },
                       "countryOfIncorporation": {
                         "title": "Country of incorporation",
                         "type": "string"
@@ -531,6 +609,64 @@
                 "format": "date"
               }
             }
+          },
+          {
+            "properties": {
+              "role": {
+                "enum": [
+                  "Giftor"
+                ]
+              },
+              "offerId": {
+                "title": "Reference to an offer in the offers object",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+              },
+              "giftDetails": {
+                "title": "Details of the gift being made towards the purchase",
+                "description": "The terms on which a giftor is contributing funds. These are the questions a conveyancer must resolve before reporting to a lender: whether the money is truly a gift rather than a loan, and whether the donor acquires any interest in or occupation of the property.",
+                "type": "object",
+                "properties": {
+                  "amount": {
+                    "title": "Amount being gifted",
+                    "type": "number",
+                    "minimum": 0
+                  },
+                  "currency": {
+                    "title": "Currency of the gift",
+                    "type": "string",
+                    "default": "GBP"
+                  },
+                  "relationshipToBuyer": {
+                    "title": "Donor's relationship to the buyer",
+                    "type": "string"
+                  },
+                  "fundsTransferred": {
+                    "title": "Whether the gift has been paid to the buyer yet",
+                    "type": "string",
+                    "enum": [
+                      "None",
+                      "Part",
+                      "All"
+                    ]
+                  },
+                  "repayable": {
+                    "title": "Whether the buyer must repay the money",
+                    "description": "If true the funds are a loan rather than a gift, which most lenders treat differently.",
+                    "type": "boolean"
+                  },
+                  "confersBeneficialInterest": {
+                    "title": "Whether the donor acquires an interest in the property",
+                    "type": "boolean"
+                  },
+                  "willOccupyProperty": {
+                    "title": "Whether the donor will live in the property after completion",
+                    "description": "An adult occupier who is not a legal owner may be required to sign a deed of consent or waiver of rights.",
+                    "type": "boolean"
+                  }
+                }
+              }
+            }
           }
         ]
       }
@@ -642,20 +778,20 @@
             },
             "ruralUrbanClassification": {
               "title": "ONS Rural Urban Classification (2021)",
-              "description": "The ONS 2021 Rural Urban Classification for the Output Area containing this property. Values follow the RUC21 categories: Urban (Nearer/Further to major town or city), Larger rural settlement (Nearer/Further), Smaller rural settlement (Nearer/Further).",
+              "description": "The human-readable Rural Urban Classification for the area containing this property. For England and Wales this is the ONS 2021 RUC21 category (e.g. \"Urban: Nearer to a major town or city\", \"Larger rural: Further from a major town or city\", \"Smaller rural: Nearer to a major town or city\"). For Scotland this is the Scottish Government Urban Rural Classification category (e.g. \"Large Urban Areas\", \"Remote Rural\"), which uses a different scheme and is not represented in ruralUrbanCode.",
               "type": "string"
             },
             "ruralUrbanCode": {
               "title": "ONS Rural Urban Classification code (2021)",
-              "description": "The ONS 2021 Rural Urban Classification code (e.g. UN1, UN2, LR1, LR2, SR1, SR2).",
+              "description": "The ONS 2021 Rural Urban Classification code for the Output Area containing this property (England and Wales only). UN1 = Urban: Nearer to a major town or city; UF1 = Urban: Further from a major town or city; RLN1 = Larger rural: Nearer; RLF1 = Larger rural: Further; RSN1 = Smaller rural: Nearer; RSF1 = Smaller rural: Further.",
               "type": "string",
               "enum": [
                 "UN1",
-                "UN2",
-                "LR1",
-                "LR2",
-                "SR1",
-                "SR2"
+                "UF1",
+                "RLN1",
+                "RLF1",
+                "RSN1",
+                "RSF1"
               ]
             },
             "region": {
@@ -837,6 +973,12 @@
           "items": {
             "type": "object",
             "properties": {
+              "mediaId": {
+                "title": "Media id",
+                "description": "Stable identifier for this media item within the transaction. Array position is not a safe reference: media is added, removed and re-ordered independently by different parties.",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+              },
               "mediaType": {
                 "title": "Type of media",
                 "type": "string",
@@ -866,6 +1008,235 @@
           "title": "About the property building",
           "type": "object",
           "properties": {
+            "attributes": {
+              "title": "Sourced building attributes",
+              "description": "Objectively sourced physical attributes of the building that contains the property, as distinct from the dwelling itself. These sit alongside the seller-declared fields in buildInformation rather than within them: everything here is measured, surveyed or registered, and none of it is asked of the seller on a form. For a house the building and the dwelling are the same thing; for a flat or maisonette these attributes describe the whole block rather than the individual unit. Values here are measured, surveyed or registered rather than declared by the seller, so they are not mapped to any form overlay. The source and verification of each value is carried by the claim that supplies it, not by this schema.",
+              "type": "object",
+              "properties": {
+                "storeyCount": {
+                  "title": "Number of storeys in the building",
+                  "description": "The number of occupiable storeys at or above ground level in the building as a whole. Unlike the sibling building/numberOfFloors, which is only available for flats and maisonettes, this is populated for every property type and always counts the whole building.",
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "heightMetres": {
+                  "title": "Height of the building in metres",
+                  "description": "The height of the building measured on the basis used by the Building Safety Act, that is from ground level to the floor surface of the top occupied storey. Populate this only where a value on that basis is available, for example from the register of higher-risk buildings. Remotely sensed estimates belong in heightToRoofBaseMetres and heightToHighestPointMetres instead.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "heightToRoofBaseMetres": {
+                  "title": "Height to the base of the roof in metres",
+                  "description": "Height from the underlying ground surface to the point where the roof meets the external walls, that is the eaves. Where a building has sections of differing height this may reflect the lowest roofline within the footprint, so it acts as a lower bound on the height of the tallest part.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "heightToHighestPointMetres": {
+                  "title": "Height to the highest point in metres",
+                  "description": "Height from the underlying ground surface to the highest point of the building, which may include chimneys, aerials, plant or other roof structures. It therefore acts as an upper bound on the height of the occupied part of the building.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "heightMeasurementDate": {
+                  "title": "Date the building height was measured",
+                  "description": "The date of the survey or aerial imagery the height values were derived from. This is the age of the underlying evidence rather than the date the value was supplied, and matters where a building has been altered or extended since it was last measured.",
+                  "type": "string",
+                  "format": "date"
+                },
+                "footprintAreaSquareMetres": {
+                  "title": "Ground floor footprint area in square metres",
+                  "description": "The area covered by the outline of the building at ground level. This is the footprint of the building and is not the internal floor area of the dwelling.",
+                  "type": "number",
+                  "minimum": 0
+                },
+                "residentialUnitCount": {
+                  "title": "Number of residential units in the building",
+                  "description": "The number of separate residential units the building contains. Both the higher-risk building and relevant building tests under the Building Safety Act require at least two dwellings, so this is needed alongside height and storey count to apply them. Where it is derived from a count of addresses it may include non-residential addresses in a mixed use building.",
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "constructionMaterial": {
+                  "title": "Primary construction material of the building",
+                  "description": "The predominant material of the external walls, for example \"Brick or block or stone\", \"Metal\", \"Timber\" or \"Other non standard or system build\". Left unconstrained because source vocabularies differ.",
+                  "type": "string"
+                },
+                "roofMaterial": {
+                  "title": "Primary roof material of the building",
+                  "description": "The predominant roof covering, for example \"Tile or stone or slate\", \"Waterproof membrane or concrete\", \"Thatch\" or \"Metal\". Left unconstrained because source vocabularies differ.",
+                  "type": "string"
+                },
+                "basementPresent": {
+                  "title": "Is a basement present in the building?",
+                  "type": "string",
+                  "enum": [
+                    "Yes",
+                    "No",
+                    "Not known"
+                  ]
+                },
+                "solarPanelsPresent": {
+                  "title": "Are solar panels present on the roof of the building?",
+                  "type": "string",
+                  "enum": [
+                    "Yes",
+                    "No",
+                    "Not known"
+                  ]
+                },
+                "constructionPeriod": {
+                  "title": "Period in which the building was constructed",
+                  "description": "A range of years within which the building was built, for example \"1870-1918\" or \"2020-2029\". Use constructionYear where a single year is known.",
+                  "type": "string"
+                },
+                "constructionYear": {
+                  "title": "Year in which the building was constructed",
+                  "type": "integer"
+                }
+              }
+            },
+            "higherRiskBuildingRegistration": {
+              "title": "Higher-risk building registration",
+              "description": "The building's entry on the register of higher-risk buildings maintained by the Building Safety Regulator under the Building Safety Act 2022. The register covers England only, and describes the building containing the property rather than the individual dwelling. Absence from the register is not proof that a building falls outside the higher-risk definition, only that no registration was found, so a \"Not found\" status should be read alongside the measured height and storey count in the sibling attributes node. Values here are taken from the register rather than declared by the seller, so they are not mapped to any form overlay.",
+              "type": "object",
+              "properties": {
+                "registrationStatus": {
+                  "title": "Registration status",
+                  "description": "\"Registered\" where an entry for this building was found. \"Not found\" where the register returned no entry, which for a building over the height or storey threshold may itself be worth raising. \"Not known\" where the register could not be searched, or returned entries that could not be narrowed to this property.",
+                  "type": "string",
+                  "enum": [
+                    "Registered",
+                    "Not found",
+                    "Not known"
+                  ]
+                },
+                "registrationNumber": {
+                  "title": "Registration number",
+                  "description": "The registration reference issued by the Building Safety Regulator, for example \"HRB15504S8K8\".",
+                  "type": "string"
+                },
+                "candidateCount": {
+                  "title": "Number of registered buildings that could not be told apart",
+                  "description": "Set only where the register returned more than one entry for the property's postcode and none could be matched to it. Recorded so the ambiguity is visible rather than resolved by guessing, and paired with a \"Not known\" registration status.",
+                  "type": "integer",
+                  "minimum": 0
+                },
+                "building": {
+                  "title": "Registered building particulars",
+                  "description": "The particulars the register holds for the building. These are as supplied by the person who registered it, so they may differ from the remotely measured values in the sibling attributes node.",
+                  "type": "object",
+                  "properties": {
+                    "name": {
+                      "title": "Registered building name",
+                      "type": "string"
+                    },
+                    "address": {
+                      "title": "Registered address",
+                      "type": "string"
+                    },
+                    "postcode": {
+                      "title": "Registered postcode",
+                      "type": "string"
+                    },
+                    "storeyCount": {
+                      "title": "Number of storeys above ground",
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "heightMetres": {
+                      "title": "Registered height of the building in metres",
+                      "description": "The height as registered, measured on the Building Safety Act basis. This is the statutory measurement rather than a remotely sensed estimate.",
+                      "type": "number",
+                      "minimum": 0
+                    },
+                    "residentialUnitCount": {
+                      "title": "Number of residential units",
+                      "type": "integer",
+                      "minimum": 0
+                    },
+                    "yearOfCompletion": {
+                      "title": "Year the building was completed",
+                      "type": "integer"
+                    },
+                    "occupied": {
+                      "title": "Are people living in the building?",
+                      "type": "string",
+                      "enum": [
+                        "Yes",
+                        "No",
+                        "Not known"
+                      ]
+                    }
+                  }
+                },
+                "completionCertificate": {
+                  "title": "Completion certificate",
+                  "type": "object",
+                  "properties": {
+                    "date": {
+                      "title": "Date of the completion certificate",
+                      "type": "string",
+                      "format": "date"
+                    },
+                    "issuer": {
+                      "title": "Who issued the completion certificate",
+                      "type": "string"
+                    },
+                    "reference": {
+                      "title": "Completion certificate reference",
+                      "type": "string"
+                    }
+                  }
+                },
+                "accountablePersons": {
+                  "title": "Accountable persons",
+                  "description": "The people or organisations accountable for the building's safety. Exactly one is the principal accountable person, who carries the duties for the structure and common parts.",
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "role": {
+                        "title": "Role",
+                        "type": "string",
+                        "enum": [
+                          "Principal accountable person",
+                          "Accountable person"
+                        ]
+                      },
+                      "personType": {
+                        "title": "Is the accountable person an organisation or an individual?",
+                        "type": "string",
+                        "enum": [
+                          "Organisation",
+                          "Individual",
+                          "Not known"
+                        ]
+                      },
+                      "name": {
+                        "title": "Name of the accountable person",
+                        "type": "string"
+                      },
+                      "accountability": {
+                        "title": "What this person is accountable for",
+                        "type": "array",
+                        "items": {
+                          "type": "object",
+                          "properties": {
+                            "section": {
+                              "title": "Part of the building",
+                              "type": "string"
+                            },
+                            "area": {
+                              "title": "Area of accountability",
+                              "type": "string"
+                            }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
             "building": {
               "title": "Building information",
               "type": "object",
@@ -956,11 +1327,6 @@
                             "Yes",
                             "No"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "required": [
@@ -5613,7 +5979,8 @@
                                 "type": "string",
                                 "enum": [
                                   "Yes",
-                                  "No"
+                                  "No",
+                                  "Not applicable"
                                 ]
                               }
                             },
@@ -5622,7 +5989,8 @@
                                 "properties": {
                                   "isGroundRentPayable": {
                                     "enum": [
-                                      "No"
+                                      "No",
+                                      "Not applicable"
                                     ]
                                   }
                                 }
@@ -6270,11 +6638,6 @@
                                           "Yes",
                                           "No"
                                         ]
-                                      },
-                                      "detailsAnalysis": {
-                                        "type": "object",
-                                        "additionalProperties": true,
-                                        "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                       }
                                     },
                                     "oneOf": [
@@ -6369,11 +6732,6 @@
                                           "Yes",
                                           "No"
                                         ]
-                                      },
-                                      "detailsAnalysis": {
-                                        "type": "object",
-                                        "additionalProperties": true,
-                                        "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                       }
                                     },
                                     "oneOf": [
@@ -6460,7 +6818,8 @@
                                         "properties": {
                                           "year": {
                                             "title": "Year",
-                                            "type": "integer"
+                                            "type": "string",
+                                            "pattern": "^(\\d{2}|\\d{4}|Not known)$"
                                           },
                                           "from": {
                                             "title": "To",
@@ -6480,7 +6839,8 @@
                                         "properties": {
                                           "year": {
                                             "title": "Year",
-                                            "type": "integer"
+                                            "type": "string",
+                                            "pattern": "^(\\d{2}|\\d{4}|Not known)$"
                                           },
                                           "from": {
                                             "title": "To",
@@ -6509,11 +6869,6 @@
                                           "Anticipated",
                                           "Not applicable"
                                         ]
-                                      },
-                                      "detailsAnalysis": {
-                                        "type": "object",
-                                        "additionalProperties": true,
-                                        "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                       }
                                     },
                                     "oneOf": [
@@ -6555,11 +6910,6 @@
                                           "Yes",
                                           "No"
                                         ]
-                                      },
-                                      "detailsAnalysis": {
-                                        "type": "object",
-                                        "additionalProperties": true,
-                                        "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                       }
                                     },
                                     "oneOf": [
@@ -7028,7 +7378,7 @@
                                               "assessmentsCarriedOut": {
                                                 "enum": [
                                                   "Fire risk assessment",
-                                                  "External Wall fire risk assessment",
+                                                  "External wall fire risk assessment",
                                                   "Both"
                                                 ]
                                               },
@@ -7344,11 +7694,6 @@
                                       "Yes",
                                       "No"
                                     ]
-                                  },
-                                  "detailsAnalysis": {
-                                    "type": "object",
-                                    "additionalProperties": true,
-                                    "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                   }
                                 },
                                 "oneOf": [
@@ -7388,11 +7733,6 @@
                                       "Yes",
                                       "No"
                                     ]
-                                  },
-                                  "detailsAnalysis": {
-                                    "type": "object",
-                                    "additionalProperties": true,
-                                    "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                   }
                                 },
                                 "oneOf": [
@@ -7558,11 +7898,6 @@
                                       "Yes",
                                       "No"
                                     ]
-                                  },
-                                  "detailsAnalysis": {
-                                    "type": "object",
-                                    "additionalProperties": true,
-                                    "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                                   }
                                 },
                                 "oneOf": [
@@ -8675,11 +9010,6 @@
                     "No",
                     "Not known"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -8807,13 +9137,9 @@
                           "title": "",
                           "enum": [
                             "Yes",
-                            "No"
+                            "No",
+                            "Not known"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -8821,7 +9147,8 @@
                           "properties": {
                             "yesNo": {
                               "enum": [
-                                "No"
+                                "No",
+                                "Not known"
                               ]
                             }
                           }
@@ -8881,11 +9208,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -8939,11 +9261,6 @@
                     "Not applicable",
                     "Not known"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -8951,7 +9268,9 @@
                   "properties": {
                     "yesNo": {
                       "enum": [
-                        "No"
+                        "No",
+                        "Not applicable",
+                        "Not known"
                       ]
                     }
                   }
@@ -9011,11 +9330,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -9071,11 +9385,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -9621,11 +9930,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -9665,11 +9969,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -9716,11 +10015,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -9740,11 +10034,89 @@
                         "Yes"
                       ]
                     },
+                    "alterationTypes": {
+                      "title": "Which of the following alterations have been made to the property?",
+                      "type": "array",
+                      "items": {
+                        "type": "string",
+                        "enum": [
+                          "Replacement windows, roof windows, roof lights, glazed doors since 1 April 2002",
+                          "Extension",
+                          "Conservatory",
+                          "Loft conversion",
+                          "Garage conversion",
+                          "Removal of internal walls",
+                          "Removal of chimney breast",
+                          "Insulation",
+                          "Other building works or changes to the property"
+                        ]
+                      }
+                    },
                     "details": {
                       "title": "Please give details including dates of all work undertaken",
                       "type": "string",
                       "minLength": 1
                     },
+                    "workCompleted": {
+                      "title": "Has all this work been completed?",
+                      "type": "object",
+                      "properties": {
+                        "yesNo": {
+                          "type": "string",
+                          "title": "",
+                          "enum": [
+                            "Yes",
+                            "No"
+                          ]
+                        }
+                      },
+                      "oneOf": [
+                        {
+                          "properties": {
+                            "yesNo": {
+                              "enum": [
+                                "Yes"
+                              ]
+                            }
+                          }
+                        },
+                        {
+                          "properties": {
+                            "yesNo": {
+                              "enum": [
+                                "No"
+                              ]
+                            },
+                            "details": {
+                              "title": "Give details of what remains to be completed",
+                              "type": "string",
+                              "minLength": 1
+                            }
+                          }
+                        }
+                      ]
+                    },
+                    "documents": {
+                      "title": "Supply copies of the planning permissions, building regulations approvals, completion certificates or competent person certificates for the work if you have them",
+                      "type": "string",
+                      "enum": [
+                        "Attached",
+                        "To follow",
+                        "Not available"
+                      ]
+                    },
+                    "approvalsObtained": {
+                      "title": "If any of the work was undertaken during your ownership, did you get planning permissions, building regulations approvals, completion certificates or competent person certificates when necessary?",
+                      "type": "string",
+                      "enum": [
+                        "Yes",
+                        "No"
+                      ]
+                    },
+                    "approvalsNotRequiredReason": {
+                      "title": "If planning permissions, building regulations approvals, completion certificates or competent person certificates were not required, explain why",
+                      "type": "string"
+                    },
                     "buildingRegApproval": {
                       "title": "Was Building Regulation approval and a completion certificate obtained or an equivalent Competent Person Scheme Certificate?",
                       "type": "object",
@@ -9757,11 +10129,6 @@
                             "No",
                             "Not required"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -9812,11 +10179,6 @@
                             "No",
                             "Not required"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -9968,11 +10330,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -10013,11 +10370,6 @@
                             "No",
                             "Not required"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -10267,11 +10619,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -10312,11 +10659,6 @@
                             "No",
                             "Not required"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -10751,11 +11093,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -10796,11 +11133,6 @@
                             "No",
                             "Not required"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -12160,11 +12492,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -12212,11 +12539,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -12272,11 +12594,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -12574,11 +12891,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -12891,11 +13203,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -14791,15 +15098,6 @@
                             }
                           }
                         }
-                      },
-                      {
-                        "properties": {
-                          "isIncludedOrExcluded": {
-                            "enum": [
-                              "None"
-                            ]
-                          }
-                        }
                       }
                     ]
                   }
@@ -18216,11 +18514,6 @@
                             "Yes",
                             "No"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -18311,11 +18604,6 @@
                             "Yes",
                             "No"
                           ]
-                        },
-                        "detailsAnalysis": {
-                          "type": "object",
-                          "additionalProperties": true,
-                          "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                         }
                       },
                       "oneOf": [
@@ -19486,6 +19774,15 @@
                                   "title": "Date last emptied",
                                   "type": "string",
                                   "format": "date"
+                                },
+                                "permitDocuments": {
+                                  "title": "Please supply a copy of any permit or other documents relating to the sewerage system.",
+                                  "type": "string",
+                                  "enum": [
+                                    "Attached",
+                                    "To follow",
+                                    "Not applicable"
+                                  ]
                                 }
                               }
                             },
@@ -19524,6 +19821,15 @@
                                   "title": "Date last emptied",
                                   "type": "string",
                                   "format": "date"
+                                },
+                                "permitDocuments": {
+                                  "title": "Please supply a copy of any permit or other documents relating to the sewerage system.",
+                                  "type": "string",
+                                  "enum": [
+                                    "Attached",
+                                    "To follow",
+                                    "Not applicable"
+                                  ]
                                 }
                               }
                             },
@@ -19583,6 +19889,15 @@
                                     "To follow",
                                     "Not applicable"
                                   ]
+                                },
+                                "permitDocuments": {
+                                  "title": "Please supply a copy of any permit or other documents relating to the sewerage system.",
+                                  "type": "string",
+                                  "enum": [
+                                    "Attached",
+                                    "To follow",
+                                    "Not applicable"
+                                  ]
                                 }
                               }
                             },
@@ -19597,6 +19912,15 @@
                                 "details": {
                                   "title": "Details",
                                   "type": "string"
+                                },
+                                "permitDocuments": {
+                                  "title": "Please supply a copy of any permit or other documents relating to the sewerage system.",
+                                  "type": "string",
+                                  "enum": [
+                                    "Attached",
+                                    "To follow",
+                                    "Not applicable"
+                                  ]
                                 }
                               }
                             }
@@ -20070,11 +20394,6 @@
                     "Room heaters only",
                     "None"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -20283,7 +20602,8 @@
                               "properties": {
                                 "yesNo": {
                                   "enum": [
-                                    "No"
+                                    "No",
+                                    "Not known"
                                   ]
                                 }
                               }
@@ -20350,7 +20670,8 @@
                               "properties": {
                                 "yesNo": {
                                   "enum": [
-                                    "Yes"
+                                    "Yes",
+                                    "Not known"
                                   ]
                                 }
                               }
@@ -20392,6 +20713,104 @@
                 }
               ]
             },
+            "mainHeatingTypes": {
+              "title": "How is the property heated?",
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "Mains gas",
+                  "Oil",
+                  "Heat pumps",
+                  "Liquid gas",
+                  "Electricity",
+                  "Underfloor",
+                  "Woodburning / multi-fuel stove",
+                  "Other"
+                ]
+              }
+            },
+            "mainHeatingTypesOtherDetails": {
+              "title": "If you selected 'Other', give details",
+              "type": "string"
+            },
+            "heatingInstalledDate": {
+              "title": "When was the heating system installed?",
+              "type": "string",
+              "oneOf": [
+                {
+                  "format": "date"
+                },
+                {
+                  "enum": [
+                    "Not known"
+                  ]
+                }
+              ]
+            },
+            "boilerInstalledDate": {
+              "title": "If there is a boiler (of any kind) when was it installed?",
+              "type": "string",
+              "oneOf": [
+                {
+                  "format": "date"
+                },
+                {
+                  "enum": [
+                    "Not known"
+                  ]
+                }
+              ]
+            },
+            "heatingSystemReplaced": {
+              "title": "Has there been any replacement to the heating system (other than replacement of a boiler)?",
+              "type": "string",
+              "enum": [
+                "Yes",
+                "No",
+                "Not known"
+              ]
+            },
+            "complianceCertificates": {
+              "title": "Supply compliance certificates or documentation for the installation or alteration of each heating system",
+              "type": "string",
+              "enum": [
+                "Attached",
+                "To follow",
+                "None"
+              ]
+            },
+            "inspectionReport": {
+              "title": "Supply a copy of the latest inspection report",
+              "type": "string",
+              "enum": [
+                "Attached",
+                "To follow",
+                "None"
+              ]
+            },
+            "inGoodWorkingOrder": {
+              "title": "Is the boiler and heating system working?",
+              "type": "string",
+              "enum": [
+                "Yes",
+                "No",
+                "Not known"
+              ]
+            },
+            "lastServicedYear": {
+              "title": "In what year was the boiler and heating system last serviced or maintained?",
+              "type": "string",
+              "pattern": "^(\\d{2}|\\d{4}|Not known)$"
+            },
+            "lastServicedReport": {
+              "title": "Supply a copy of the service report",
+              "type": "string",
+              "enum": [
+                "Attached",
+                "To follow"
+              ]
+            },
             "otherHeatingFeatures": {
               "title": "What other heating features does the property have?",
               "type": "array",
@@ -20429,6 +20848,40 @@
                 "To follow",
                 "Not applicable"
               ]
+            },
+            "mainsGas": {
+              "title": "Mains gas",
+              "description": "Whether the property is connected to a mains gas supply, whatever the gas is used for.",
+              "type": "object",
+              "properties": {
+                "yesNo": {
+                  "title": "",
+                  "type": "string",
+                  "enum": [
+                    "Yes",
+                    "No"
+                  ]
+                },
+                "supplier": {
+                  "title": "Supplier",
+                  "type": "string"
+                },
+                "gasMeter": {
+                  "title": "Gas meter",
+                  "type": "object",
+                  "properties": {
+                    "location": {
+                      "title": "Describe the location of the meter",
+                      "type": "string"
+                    },
+                    "mprn": {
+                      "title": "Meter Point Reference Number (MPRN)",
+                      "description": "Your MPRN is on your gas bill, usually labelled 'Meter Point Reference Number' or 'MPRN'. It's normally between 6 and 10 digits long.",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
             }
           }
         },
@@ -20799,11 +21252,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -20843,11 +21291,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -20887,11 +21330,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -20931,11 +21369,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -21023,11 +21456,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -21083,7 +21511,8 @@
                   "properties": {
                     "yesNo": {
                       "enum": [
-                        "No"
+                        "No",
+                        "Not applicable"
                       ]
                     }
                   }
@@ -21155,6 +21584,45 @@
                     "Yes",
                     "No"
                   ]
+                },
+                "disagreementOrComplaint": {
+                  "title": "Are you aware of any disagreement or complaint about any such right or arrangement?",
+                  "type": "object",
+                  "properties": {
+                    "yesNo": {
+                      "type": "string",
+                      "enum": [
+                        "Yes",
+                        "No",
+                        "Not known"
+                      ]
+                    }
+                  },
+                  "oneOf": [
+                    {
+                      "properties": {
+                        "yesNo": {
+                          "enum": [
+                            "No",
+                            "Not known"
+                          ]
+                        }
+                      }
+                    },
+                    {
+                      "properties": {
+                        "yesNo": {
+                          "enum": [
+                            "Yes"
+                          ]
+                        },
+                        "details": {
+                          "type": "string",
+                          "minLength": 1
+                        }
+                      }
+                    }
+                  ]
                 }
               },
               "oneOf": [
@@ -21179,45 +21647,6 @@
                       "type": "string",
                       "minLength": 1
                     },
-                    "disagreementOrComplaint": {
-                      "title": "Are you aware of any disagreement or complaint about any such right or arrangement?",
-                      "type": "object",
-                      "properties": {
-                        "yesNo": {
-                          "type": "string",
-                          "enum": [
-                            "Yes",
-                            "No",
-                            "Not known"
-                          ]
-                        }
-                      },
-                      "oneOf": [
-                        {
-                          "properties": {
-                            "yesNo": {
-                              "enum": [
-                                "No",
-                                "Not known"
-                              ]
-                            }
-                          }
-                        },
-                        {
-                          "properties": {
-                            "yesNo": {
-                              "enum": [
-                                "Yes"
-                              ]
-                            },
-                            "details": {
-                              "type": "string",
-                              "minLength": 1
-                            }
-                          }
-                        }
-                      ]
-                    },
                     "attachments": {
                       "title": "Attachments",
                       "type": "string",
@@ -21249,7 +21678,8 @@
                   "properties": {
                     "yesNo": {
                       "enum": [
-                        "No"
+                        "No",
+                        "Not known"
                       ]
                     }
                   }
@@ -21976,7 +22406,8 @@
                       "type": "string",
                       "enum": [
                         "Yes",
-                        "No"
+                        "No",
+                        "Not known"
                       ]
                     }
                   },
@@ -21985,7 +22416,8 @@
                       "properties": {
                         "hasFloodDefences": {
                           "enum": [
-                            "No"
+                            "No",
+                            "Not known"
                           ]
                         }
                       }
@@ -23199,8 +23631,7 @@
                   "properties": {
                     "riskIndicator": {
                       "enum": [
-                        "No",
-                        "Not known"
+                        "No"
                       ]
                     }
                   }
@@ -23708,11 +24139,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -23752,11 +24178,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -23796,11 +24217,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -23848,11 +24264,6 @@
                     "Yes",
                     "No"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -23895,101 +24306,67 @@
                     "Not applicable"
                   ]
                 },
-                "detailsAnalysis": {
+                "uniformBoundaries": {
+                  "title": "Please indicate who has repaired, or treated as belonging to them, each of the boundaries. Identify each boundary as if you were looking at the property from the road.",
+                  "ta6title": "Looking towards the property from the road, who owns or accepts responsibility to maintain or repair the boundary features:",
                   "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
-                }
-              },
-              "oneOf": [
-                {
                   "properties": {
-                    "areBoundariesUniform": {
+                    "left": {
+                      "title": "On the left",
+                      "type": "string",
                       "enum": [
-                        "Yes"
+                        "Seller",
+                        "Shared",
+                        "Neighbour",
+                        "Not known"
                       ]
                     },
-                    "uniformBoundaries": {
-                      "title": "Please indicate who has repaired, or treated as belonging to them, each of the boundaries. Identify each boundary as if you were looking at the property from the road.",
-                      "ta6title": "Looking towards the property from the road, who owns or accepts responsibility to maintain or repair the boundary features:",
-                      "type": "object",
-                      "properties": {
-                        "left": {
-                          "title": "On the left",
-                          "type": "string",
-                          "enum": [
-                            "Seller",
-                            "Shared",
-                            "Neighbour",
-                            "Not known"
-                          ]
-                        },
-                        "right": {
-                          "title": "On the right",
-                          "type": "string",
-                          "enum": [
-                            "Seller",
-                            "Shared",
-                            "Neighbour",
-                            "Not known"
-                          ]
-                        },
-                        "rear": {
-                          "title": "At the rear",
-                          "type": "string",
-                          "enum": [
-                            "Seller",
-                            "Shared",
-                            "Neighbour",
-                            "Not known"
-                          ]
-                        },
-                        "front": {
-                          "title": "At the front",
-                          "type": "string",
-                          "enum": [
-                            "Seller",
-                            "Shared",
-                            "Neighbour",
-                            "Not known"
-                          ]
-                        }
-                      }
-                    }
-                  }
-                },
-                {
-                  "properties": {
-                    "areBoundariesUniform": {
+                    "right": {
+                      "title": "On the right",
+                      "type": "string",
                       "enum": [
-                        "No"
+                        "Seller",
+                        "Shared",
+                        "Neighbour",
+                        "Not known"
                       ]
                     },
-                    "details": {
-                      "title": "Please indicate ownership or those you have repaired by written description or marking them on a plan of the property",
+                    "rear": {
+                      "title": "At the rear",
                       "type": "string",
-                      "minLength": 1
+                      "enum": [
+                        "Seller",
+                        "Shared",
+                        "Neighbour",
+                        "Not known"
+                      ]
                     },
-                    "attachments": {
-                      "title": "Attachments",
+                    "front": {
+                      "title": "At the front",
                       "type": "string",
                       "enum": [
-                        "Attached",
-                        "To follow"
+                        "Seller",
+                        "Shared",
+                        "Neighbour",
+                        "Not known"
                       ]
                     }
                   }
                 },
-                {
-                  "properties": {
-                    "areBoundariesUniform": {
-                      "enum": [
-                        "Not applicable"
-                      ]
-                    }
-                  }
+                "details": {
+                  "title": "Please indicate ownership or those you have repaired by written description or marking them on a plan of the property",
+                  "type": "string",
+                  "minLength": 1
+                },
+                "attachments": {
+                  "title": "Attachments",
+                  "type": "string",
+                  "enum": [
+                    "Attached",
+                    "To follow"
+                  ]
                 }
-              ]
+              }
             },
             "haveBoundaryFeaturesMoved": {
               "title": "Has any boundary features been moved during your ownership or in the last 10 years, to your knowledge?",
@@ -24003,11 +24380,6 @@
                     "No",
                     "Not applicable"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -24049,11 +24421,6 @@
                     "No",
                     "Not applicable"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -24097,11 +24464,6 @@
                     "Not applicable",
                     "Not known"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -24110,7 +24472,8 @@
                     "yesNo": {
                       "enum": [
                         "No",
-                        "Not applicable"
+                        "Not applicable",
+                        "Not known"
                       ]
                     }
                   }
@@ -24350,11 +24713,6 @@
                     "No",
                     "Not known"
                   ]
-                },
-                "detailsAnalysis": {
-                  "type": "object",
-                  "additionalProperties": true,
-                  "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                 }
               },
               "oneOf": [
@@ -24388,6 +24746,14 @@
                       "title": "Please supply one of the following:",
                       "type": "object",
                       "properties": {
+                        "yesNo": {
+                          "title": "Does the property have any certificates for electrical installation works?",
+                          "type": "string",
+                          "enum": [
+                            "Yes",
+                            "No"
+                          ]
+                        },
                         "certificateType": {
                           "type": "string",
                           "enum": [
@@ -24614,11 +24980,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -25124,11 +25485,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -25215,11 +25571,6 @@
                         "Yes",
                         "No"
                       ]
-                    },
-                    "detailsAnalysis": {
-                      "type": "object",
-                      "additionalProperties": true,
-                      "description": "Optional sibling object carrying vendor-emitted analysis of the parent's `details` free-text disclosure. Payload shape is vendor-specific; consumers that don't recognise the shape should ignore the object."
                     }
                   },
                   "oneOf": [
@@ -25678,6 +26029,12 @@
                   "signedOn"
                 ],
                 "properties": {
+                  "signatureId": {
+                    "title": "Signature id",
+                    "description": "Stable identifier for this signature within the transaction. Array position is not a safe reference: signatories sign independently and in any order.",
+                    "type": "string",
+                    "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+                  },
                   "name": {
                     "title": "Name of signatory",
                     "type": "string",
@@ -37788,6 +38145,12 @@
           "items": {
             "type": "object",
             "properties": {
+              "searchId": {
+                "title": "Search id",
+                "description": "Stable identifier for this search within the transaction. Array position is not a safe reference: searches are ordered and updated independently by different parties.",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+              },
               "displayName": {
                 "title": "Human-readable name of instructed search product",
                 "type": "string",
@@ -37878,6 +38241,12 @@
           "items": {
             "type": "object",
             "properties": {
+              "documentId": {
+                "title": "Document id",
+                "description": "Stable identifier for this document within the transaction. Array position is not a safe reference: documents are added, removed and re-ordered independently by different parties.",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+              },
               "displayName": {
                 "title": "Human-readable name of document",
                 "type": "string",
@@ -37939,6 +38308,12 @@
           "items": {
             "type": "object",
             "properties": {
+              "surveyId": {
+                "title": "Survey id",
+                "description": "Stable identifier for this survey within the transaction. Array position is not a safe reference: a property may be surveyed more than once, by different parties.",
+                "type": "string",
+                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+              },
               "outside": {
                 "type": "object",
                 "properties": {
@@ -40679,6 +41054,12 @@
       "items": {
         "type": "object",
         "properties": {
+          "contractId": {
+            "title": "Contract id",
+            "description": "Stable identifier for this contract within the transaction. Array position is not a safe reference: contracts are added and superseded independently by different parties.",
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+          },
           "contract": {
             "type": "object",
             "required": [
@@ -40771,6 +41152,12 @@
                 "contractHash"
               ],
               "properties": {
+                "signatureId": {
+                  "title": "Signature id",
+                  "description": "Stable identifier for this signature within the contract. Array position is not a safe reference: signatories sign independently and in any order.",
+                  "type": "string",
+                  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:+-]*$"
+                },
                 "name": {
                   "type": "string"
                 },
@@ -40935,106 +41322,107 @@
               }
             }
           }
-        }
-      },
-      "buyersSale": {
-        "type": "array",
-        "minItems": 1,
-        "items": {
-          "type": "object",
-          "title": "The property(ies) the buyer/buyers are selling to finance the purchase",
-          "properties": {
-            "transactionId": {
-              "title": "UUID for an onward transaction",
-              "type": "string"
-            },
-            "externalIds": {
-              "type": "object",
-              "patternProperties": {
-                ".*": {
-                  "oneOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "number"
-                    },
-                    {
-                      "type": "boolean"
-                    },
-                    {
-                      "type": "object",
-                      "patternProperties": {
-                        ".*": {}
+        },
+        "buyersSale": {
+          "description": "The property or properties the buyer must sell in order to proceed with this purchase. Whether the buyer depends on a sale at all is recorded in the offer's buyerCircumstances.dependentOnSale.",
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "title": "The property(ies) the buyer/buyers are selling to finance the purchase",
+            "properties": {
+              "transactionId": {
+                "title": "UUID for the buyer's sale transaction",
+                "type": "string"
+              },
+              "externalIds": {
+                "type": "object",
+                "patternProperties": {
+                  ".*": {
+                    "oneOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "boolean"
+                      },
+                      {
+                        "type": "object",
+                        "patternProperties": {
+                          ".*": {}
+                        }
                       }
-                    }
-                  ]
+                    ]
+                  }
                 }
-              }
-            },
-            "address": {
-              "title": "Address",
-              "type": "object",
-              "properties": {
-                "buildingNumber": {
-                  "title": "Building number",
-                  "type": "string",
-                  "minLength": 1
-                },
-                "buildingName": {
-                  "title": "Building name",
-                  "type": "string"
-                },
-                "subBuilding": {
-                  "title": "Sub building name",
-                  "type": "string"
-                },
-                "street": {
-                  "title": "Street",
-                  "type": "string",
-                  "minLength": 1
-                },
-                "line1": {
-                  "title": "Address 1",
-                  "type": "string",
-                  "minLength": 1
-                },
-                "line2": {
-                  "title": "Address 2",
-                  "type": "string"
-                },
-                "line 3": {
-                  "title": "Address 3",
-                  "type": "string"
-                },
-                "town": {
-                  "title": "Town",
-                  "type": "string"
-                },
-                "postcode": {
-                  "title": "Postcode",
-                  "type": "string",
-                  "minLength": 1
-                },
-                "homeNation": {
-                  "title": "Home nation",
-                  "type": "string",
-                  "enum": [
-                    "England",
-                    "Wales",
-                    "Scotland",
-                    "Northern Ireland"
-                  ]
+              },
+              "address": {
+                "title": "Address",
+                "type": "object",
+                "properties": {
+                  "buildingNumber": {
+                    "title": "Building number",
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "buildingName": {
+                    "title": "Building name",
+                    "type": "string"
+                  },
+                  "subBuilding": {
+                    "title": "Sub building name",
+                    "type": "string"
+                  },
+                  "street": {
+                    "title": "Street",
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "line1": {
+                    "title": "Address 1",
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "line2": {
+                    "title": "Address 2",
+                    "type": "string"
+                  },
+                  "line 3": {
+                    "title": "Address 3",
+                    "type": "string"
+                  },
+                  "town": {
+                    "title": "Town",
+                    "type": "string"
+                  },
+                  "postcode": {
+                    "title": "Postcode",
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "homeNation": {
+                    "title": "Home nation",
+                    "type": "string",
+                    "enum": [
+                      "England",
+                      "Wales",
+                      "Scotland",
+                      "Northern Ireland"
+                    ]
+                  }
                 }
+              },
+              "uprn": {
+                "title": "Unique Property Reference Number",
+                "type": "integer"
+              },
+              "sellingAgent": {
+                "title": "Estate Agent selling the property",
+                "type": "string"
               }
-            },
-            "uprn": {
-              "title": "Unique Property Reference Number",
-              "type": "integer"
-            },
-            "sellingAgent": {
-              "title": "Estate Agent selling the property",
-              "type": "string"
             }
           }
         }
@@ -41228,6 +41616,56 @@
                 }
               }
             },
+            "metadata": {
+              "title": "Offer metadata",
+              "description": "Flexible container for vendor-specific metadata items relating to this offer, keyed by vendor namespace (e.g. /offers/{id}/metadata/Moverly/lenderCompatibilityAnalysis). Values may be strings, numbers, booleans or nested objects. Paths are addressable up to three levels below metadata (e.g. /offers/{id}/metadata/vendor/item/field).",
+              "type": "object",
+              "patternProperties": {
+                ".*": {
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "number"
+                    },
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "object",
+                      "patternProperties": {
+                        ".*": {
+                          "oneOf": [
+                            {
+                              "type": "string"
+                            },
+                            {
+                              "type": "number"
+                            },
+                            {
+                              "type": "boolean"
+                            },
+                            {
+                              "type": "array"
+                            },
+                            {
+                              "type": "null"
+                            },
+                            {
+                              "type": "object",
+                              "patternProperties": {
+                                ".*": {}
+                              }
+                            }
+                          ]
+                        }
+                      }
+                    }
+                  ]
+                }
+              }
+            },
             "buyerCircumstances": {
               "title": "Buyer circumstances",
               "description": "Information about the buyer's circumstances for lender compatibility analysis and conveyancing quotes",
@@ -41236,6 +41674,7 @@
                 "intendedUse": {
                   "type": "string",
                   "title": "Intended use of property",
+                  "description": "The primary purpose of the purchase: whether the buyer will live at the property as their main home, and if not, on what basis it is held. Other circumstances are recorded in the separate fields below and are never values of this field. A home-worker is \"Owner occupied\" with intendsBusiness true. A property bought for a relative to live in is \"Second home\" (no rent) or \"Buy-to-let\" (rent paid), with occupiedByFamilyMember true. A purchase to renovate and sell is \"Second home\" with intendsAlterations and intendsResale true.",
                   "enum": [
                     "Owner occupied",
                     "Buy-to-let",
@@ -41281,6 +41720,99 @@
                     "Yes",
                     "No"
                   ]
+                },
+                "isAdditionalProperty": {
+                  "type": "boolean",
+                  "title": "Additional property purchase",
+                  "description": "Whether the buyer already owns residential property (SDLT higher rates apply)"
+                },
+                "dependentOnSale": {
+                  "type": "boolean",
+                  "title": "Buyer needs to sell a property to proceed",
+                  "description": "Whether the buyer's purchase depends on the sale of another property, i.e. the buyer's side of the chain. False positively records that it does not, for example a first-time buyer or a buyer who has already sold; absent means the buyer's position is not known. Owning another property is not the same thing: see isAdditionalProperty. The property or properties being sold are recorded in chain.buyersSale."
+                },
+                "hasPets": {
+                  "type": "boolean",
+                  "title": "Buyer has pets",
+                  "description": "Relevant to lease and covenant pet restriction assessment"
+                },
+                "petDetails": {
+                  "type": "string",
+                  "title": "Pets or other animals",
+                  "description": "The pets, horses or other animals the buyer intends to keep at the property, and how many (e.g. \"2 dogs, 1 cat\")"
+                },
+                "occupiedByFamilyMember": {
+                  "type": "boolean",
+                  "title": "Occupied by a member of the buyer's family",
+                  "description": "Whether a member of the buyer's family, rather than the buyer, will live at the property. Recorded with intendedUse \"Second home\" when no rent is paid, or \"Buy-to-let\" when it is. Relevant to lender acceptability, occupancy and tax assessment"
+                },
+                "intendsSublet": {
+                  "type": "boolean",
+                  "title": "Buyer intends to sublet",
+                  "description": "Relevant to lease and covenant subletting restriction assessment"
+                },
+                "subletType": {
+                  "type": "string",
+                  "title": "Type of subletting intended",
+                  "enum": [
+                    "AST",
+                    "Lodger",
+                    "Airbnb",
+                    "HMO",
+                    "Company let",
+                    "Other"
+                  ]
+                },
+                "intendsBusiness": {
+                  "type": "boolean",
+                  "title": "Buyer intends business use",
+                  "description": "Relevant to covenant and lease business-use restriction assessment"
+                },
+                "businessType": {
+                  "type": "string",
+                  "title": "Type of business intended"
+                },
+                "businessUseType": {
+                  "type": "string",
+                  "title": "Extent of intended business use",
+                  "description": "How the business use recorded in intendsBusiness will affect the property: working from home with no visitors, clients or staff visiting, or using the property or part of it as business premises such as a shop, office or surgery. For a mixed-use purchase, intendedUse records the residential occupation and this field records the business part. Relevant to use covenants, lease restrictions and planning use class",
+                  "enum": [
+                    "Working from home",
+                    "Clients or staff visit",
+                    "Business premises"
+                  ]
+                },
+                "intendsAlterations": {
+                  "type": "boolean",
+                  "title": "Buyer intends significant alterations",
+                  "description": "Relevant to covenant, planning and building regulations assessment"
+                },
+                "alterationDescription": {
+                  "type": "string",
+                  "title": "Planned alterations",
+                  "description": "What the buyer intends to alter, extend or develop"
+                },
+                "intendsResale": {
+                  "type": "boolean",
+                  "title": "Buyer intends to sell after works",
+                  "description": "Whether the buyer intends to sell the property, or parts of it, once planned works are complete, rather than live in it or let it. Relevant to covenant, planning, lender and tax assessment"
+                },
+                "vehicleRequirements": {
+                  "type": "string",
+                  "title": "Vehicles to keep at the property",
+                  "description": "Any caravan, motorhome, commercial vehicle or boat the buyer intends to keep at the property. Relevant to parking and use covenants"
+                },
+                "financingMethod": {
+                  "type": "string",
+                  "title": "Primary financing method",
+                  "description": "How the purchase is funded, distinct from intendedUse (how the property will be used)",
+                  "enum": [
+                    "Mortgage",
+                    "Cash",
+                    "Shared ownership",
+                    "Help to Buy",
+                    "Right to Buy"
+                  ]
                 }
               },
               "required": [
@@ -41414,7 +41946,13 @@
                     },
                     "nominatedLender": {
                       "type": "string",
-                      "title": "Nominated lender"
+                      "title": "Nominated lender",
+                      "description": "The nominated lender's name as entered or selected"
+                    },
+                    "nominatedLenderHandbookId": {
+                      "type": "string",
+                      "title": "Nominated lender (UK Finance Handbook id)",
+                      "description": "The nominated lender's identifier in the UK Finance Mortgage Lenders' Handbook, e.g. nationwide-building-society, so lender requirements can be looked up without matching on name"
                     }
                   }
                 }