To perform a new Land Registry check you must send a POST request to the /api/v2/ci/entities/{entityId}/data-checks/land-registry endpoint.
You must specify an entityId as part of this request. If you do not have an existing Entity that you wish to use you must first create an Entity - see the Create a new Entity page for more details on this.
As part of your request you must specify a request body, such as:
{
"runProofOfOwnershipCheck": true,
"downloadTitleDeed": true,
"downloadTitlePlan": true,
"firstName": "string",
"middleName": "string",
"surname": "string",
"addressLine1": "string",
"addressLine2": "string",
"city": "string",
"postcode": "string"
}
runProofOfOwnershipCheck
If this is set to true, we will check that the person's details (firstName, surname etc.) are on the register for the property (i.e. are they an owner of the property).
downloadTitleDeed
If this is set to true, we will return a fileId in the response object which will allow you to download the Title Deed as a PDF (see later in this article).
downloadTitlePlan
If this is set to true, we will return the a fileId in the response object which will allow you to download the Title Plan as a PDF (see later in this article).
Response body
This is a synchronous routine, so the response you receive will contain the result of the check.
{
"landRegistryCheck": {
"id": 0,
"entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"dateCreated": "2024-03-12T11:39:48.748Z",
"input": {
"firstName": "string",
"middleName": "string",
"surname": "string",
"addressLine1": "string",
"addressLine2": "string",
"postcode": "string",
"city": "string"
},
"result": {
"includesProofOfOwnership": true,
"overallResult": 0,
"matches": [
{
"titleNumber": "string",
"firstNameMatch": 0,
"middleNameMatch": 0,
"surnameMatch": 0,
"overallMatch": 0,
"isHistorical": true,
"ownershipType": 0,
"proprietorFrom": "2024-03-12T11:39:48.748Z",
"proprietorTo": "2024-03-12T11:39:48.748Z",
"property": {
"buildingName": "string",
"buildingNumber": "string",
"streetName": "string",
"city": "string",
"postcode": "string",
"subBuildingName": "string",
"tenure": "string"
}
}
],
"files": [
{
"fileId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"filename": "string",
"titleNumber": "string"
}
],
"titles": [
{
"address": "string",
"tenure": "string",
"titleNumber": "string",
"isOutOfHours": true
}
]
},
"isOutOfHours": true
},
"requiresAdditionalTitleRetrieval": true,
"titleNumberDetails": [
{
"titleNumber": "string",
"tenure": "string",
"address": "string"
}
]
}
overallResult
This is the overall result of the Proof of Ownership check, and will be one of the following values:
0 | Not Performed |
1 | Auto Pass |
| 2 | Auto Fail |
| 3 | Pending Manual Check |
| 4 | Manual Pass |
| 5 | Manual Fail |
| 6 | Manual Refer |
| 7 | Requested |
Please refer to the schema for this endpoint on our Swagger page for details of each Enum value.
Downloading the Title Deed
The Title Deed can be downloaded via the GET /api/v2/ci/entities/{entityId}/data-checks/{dataCheckId}/land-registry/files/{fileId} endpoint.
You will need to pass the following parameters:
- entityID - created when you created your Entity)
- dataCheckId - returned in the response from the Land-Registry check (the "id" parameter in the "landRegistryCheck" section.
- fileId - returned in the response from the Land-Registry check, in the "files" section - the entry with the word 'Register' in the "filename"
Downloading the Title Plan
The Title Plan can be downloaded via the GET /api/v2/ci/entities/{entityId}/data-checks/{dataCheckId}/land-registry/files/{fileId} endpoint.
You will need to pass the following parameters:
- entityID - created when you created your Entity)
- dataCheckId - returned in the response from the Land-Registry check (the "id" parameter in the "landRegistryCheck" section.
- fileId - returned in the response from the Land-Registry check, in the "files" section - the entry with the word 'Title_Plan' in the "filename"
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article