Registered Proprietor Names
Overview
Check the name and type of registered proprietors of a registered title throughout the process from instruction to application submission. The name can then be compared against the name stored within the casework management system and documentation. If a discrepancy exists, appropriate evidence can be submitted with the application to account for the discrepancy, which will prevent the need for a requisition to be sent when the application is considered by a caseworker. This service can be called as many times as is required but it is only to be used in the support of lodging applications to change the register.
Process flow
To request the names of the registered proprietors of a title, you will need to input the title number into your Case Management Software:
Input
- login details
- title number
Output
- registered proprietor names
- type of proprietor (private individual or organisation)
- if organisation:
- type of organisation (refer to OpenApi specification)
- if type of organisation is a company:
- company location (England or Wales, Scotland, Northern Ireland, Overseas)
Process flow diagram
Service working hours
The Business Gateway service is available between 6.30am and 11pm. This service will not be available between 11pm and 6.30am the following morning. These times are in relation to the current time zone in London.
Rate limiting
Access control
To use this service you will need to be an existing Business Gateway user. You will
also need to ensure that users have been allocated a role that includes eConveyancer,
Edit and Submit and/or e-DRS (CSU or DRS, or WM1, C4, WM5 or Z2). For further
guidance please see:
https://www.gov.uk/guidance/land-registry-portal-update-a-user-account
You will also need to request permission for any organisation to use the service. This can be done by contacting channelpartners@landregistry.gov.uk.
If you would like to integrate with this service you can request access at https://www.gov.uk/guidance/apply-for-hm-land-registry-business-e-services.
Error and status codes
When developing against the tabel below, please use the status code. Error codes are currently in place but are subject to change or may disappear in the future.
| HTTP Code | Condition | Error Code | Error Message |
|---|---|---|---|
| 429 | Thrown when a user exceeds their allowed 60 second request limit | BG40006 | Too many requests, please wait and try again |
| 423 | Thrown when the service is out of opening hours | BG50003 | rpn service is currently out of hours |
| 404 | Thrown when a title is not found | BG40002 | Title is not found. |
| 403 | Thrown when the user’s organisation is not permitted to use the service | BG40003 | Organisation is not allowed access to this service. |
| 403 | Thrown when a user does not have the correct role to use the service | BG40005 | Forbidden |
| 401 | Thrown when invalid credentials are used or account status is not active | BG40004 | Unauthorized |
| 400 | Thrown when a constraint violation exception is thrown. The title number is not in a recognised format | BG40001 | Malformed invalid schema. Title is invalid |
| 503 | Thrown when the service is down for a non-specific reason | BG50002 | Service unavailable |
| 500 | Thrown when no other specific exception is thrown | BG50001 | Internal server error |
| 504 | Internal service timeout | BG50004 | Gateway timeout |
Customer test stubs
Endpoint URL
The test environment can be accessed at:
https://bgtest.landregistry.gov.uk/bg2test/api/v1/titles/<title_number>/registered-proprietor-names
Where <title_number> is replaced by the title number you need to use.
This requires a customer test certificate (this is different to the production client certificates).
The previous test environment url has been deprecated:
https://bgtest.landregistry.gov.uk/bg2test/s2/v1/titles/
Scenarios when the registered proprietor names are returned
Scenario 1 - Single private individual
Title Number - AB1208001
{
"data": {
"title_status": "Title number is valid",
"title_status_code": "VALID",
"title_number": "AB1208001",
"proprietors": [
{
"sequence": 1,
"proprietor_name": "Mr Joe Bloggs OBE",
"title": "Mr",
"forenames": "Joe",
"surname": "Bloggs",
"decoration": "OBE",
"proprietor_type": "PRIVATE_INDIVIDUAL"
}
]
}
}
Scenario 2 - Two or more private individuals
Title Number - AB1208002
{
"data": {
"title_status": "Title number is valid",
"title_status_code": "VALID",
"title_number": "AB1208002",
"proprietors": [
{
"sequence": 1,
"proprietor_name": "Mr Joe Bloggs OBE",
"title": "Mr",
"forenames": "Joe",
"surname": "Bloggs",
"decoration": "OBE",
"proprietor_type": "PRIVATE_INDIVIDUAL"
},
{
"sequence": 2,
"proprietor_name": "Mrs Elizabeth Anne Smith OBE",
"title": "Mrs",
"forenames": "Elizabeth Anne",
"surname": "Smith",
"decoration": "OBE",
"proprietor_type": "PRIVATE_INDIVIDUAL"
}
]
}
}
Scenario 3 - One private individual and One UK company
Title Number - AB1208003
{
"data": {
"title_status": "Title number is valid",
"title_status_code": "VALID",
"title_number": "AB1208003",
"proprietors": [
{
"sequence": 1,
"proprietor_name": "Mr Joe Bloggs OBE",
"title": "Mr",
"forenames": "Joe",
"surname": "Bloggs",
"decoration": "OBE",
"proprietor_type": "PRIVATE_INDIVIDUAL"
},
{
"sequence": 2,
"proprietor_name": "csda plc",
"organisation_type": "CORPORATE_BODY",
"company_location": "ENGLAND_OR_WALES",
"proprietor_type": "ORGANISATION"
}
]
}
}
Scenario 4 - One overseas company
Title Number - AB1208004
{
"data": {
"title_status": "Title number is valid",
"title_status_code": "VALID",
"title_number": "AB1208004",
"proprietors": [
{
"sequence": 1,
"proprietor_name": "beach towels plc",
"organisation_type": "CORPORATE_BODY",
"company_location": "OVERSEAS",
"proprietor_type": "ORGANISATION"
}
]
}
}
Scenario 5 - One organisation, type = local authority
Title Number - AB1208005
{
"data": {
"title_status": "Title number is valid",
"title_status_code": "VALID",
"title_number": "AB1208005",
"proprietors": [
{
"sequence": 1,
"proprietor_name": "new town care",
"organisation_type": "LOCAL_AUTHORITY",
"company_location": "ENGLAND_OR_WALES",
"proprietor_type": "ORGANISATION"
}
]
}
}
Scenarios when the registered proprietor names are not returned
Scenario 6 - Invalid title format
Title Number - ABCDF3438P
{
"errors": [
{
"timestamp": "2022-03-15T09:52:40.758182",
"http_status": "400",
"error_code": "BG40001",
"error_message": "Malformed invalid schema. Title is invalid."
}
]
}
Scenario 7 - Title not found
Title Number - CD1208001
{
"errors": [
{
"timestamp": "2022-03-15T09:52:40.758182",
"http_status": "404",
"error_code": "BG40002",
"error_message": "Title is not found."
}
]
}
Scenario 8 - Closed title
Title Number - DT501578
{
"data": {
"title_status": "According to our records, this title number has been closed or cancelled.",
"title_status_code": "CLOSED_OR_CANCELLED",
"title_number": "DT501578",
"proprietors": []
}
}
Scenario 9 - Closed and continued title
Title Number - GR519468
{
"data": {
"title_status": "According to our records, this title number has been closed and continued under another title number.",
"title_status_code": "CLOSED_AND_CONTINUED",
"title_number": "GR519468",
"continued_under_title_number": "EF1208001",
"proprietors": []
}
}
Scenario 10 - Pending new title (i.e. register not created yet)
Title Number - GR514443
{
"data": {
"title_status": "This is pending a new title.",
"title_status_code": "PENDING_NEW_TITLE",
"title_number": "GR514443",
"proprietors": []
}
}
Scenario 11 - Organisation not on allow list
Title Number - CD1208005
{
"errors": [
{
"error_code": "BG40003",
"error_message": "Organisation is not allowed access to this service.",
"http_status": "403",
"timestamp": "2022-03-15T09:52:40.758182"
}
]
}
Scenario 12 - Out of business hours
Title Number - CD1208006
{
"errors": [
{
"error_code": "BG50003",
"error_message": "rpn service is currently out of hours",
"http_status": "423",
"timestamp": "2022-03-17T16:24:50.309567"
}
]
}
Scenario 13 - Exceeds rate limiting
Title Number - CD1208007
{
"errors": [
{
"error_code": "BG40006",
"error_message": "Too many requests, please wait and try again",
"http_status": "429",
"timestamp": "2022-03-17T16:23:27.60063"
}
]
}
Additional
In rare circumstances we will not be able to return names of the registered proprietors, even if the title number you have entered is valid. You will not receive an error message, instead the name fields will be blank.
Action to take if discrepancy exists
If the name(s) returned do not match against the name within the casework
management system, end users should be reminded they will need to account for the
discrepancy through the submission of documentary evidence with the application to
change the register.
To see a process diagram on how to deal with unexpected
responses, click here
(will open pdf in a new window).
Schemas
