API docs by Redocly

Register land and property API (1.0)

Download OpenAPI specification:Download

Character set support

Every string must use the ISO-8859-1 character set, and control characters are not permitted.

Input may be validated with this regular expression: ^[\u0020-\u007E|\u00A1-\u00AC|\u00AE-\u00FF]*$

Environments

Sandbox — https://api.sandbox.ros.gov.uk/v1/
Production — https://api.ros.gov.uk/v1/

Supporting information

Fetch title information

Returns the status and registered securities for a title. Details of closed, cancelled and amalgamated titles will not be returned. For draft titles, securities will not be returned.

Authorizations:
OAuth2.0-Client-Credentials
path Parameters
titleNumber
required
string [ 4 .. 11 ] characters ^[A-Z]{3}[0-9]{1,8}$
Example: MID15313

Title number

Responses

Response samples

Content type
application/json
{
  • "titleNumber": "MID15313",
  • "titleType": "12",
  • "status": "REGISTERED",
  • "securities": [
    ]
}

Search for creditors

Search known creditors for use as the applicant of a standard security.

This API will return a maximum of 15 results.

Authorizations:
OAuth2.0-Client-Credentials
query Parameters
query
required
string [ 3 .. 20 ] characters
Example: query=santander

Search query

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create case

Create a new RLP case

Create a new RLP case. The matter reference, subject details, FAS number and agent contact details must all be supplied.

Authorizations:
OAuth2.0-Client-Credentials
Request Body schema: application/json
reference
required
string <= 50 characters
Example: "SMITH/2023/8"

Agent's matter reference for the case. Uniqueness is recommended but not required.

required
object (Agent)

FAS number and contact details for the agent

fas
required
string [ 4 .. 6 ] characters ^[0-9]{4,6}$
Example: "1877"

A FAS number belonging to the organisation, with an SL2 Direct Debit subledger. Must be 4-6 digits; leading zeros are important so the value must be supplied as a string.

contactEmail
required
string <= 255 characters
Example: "beth.harper@abcsolicitors.com"

A contact email address for the case. The exact pattern for a valid email address cannot be documented here.

contactTelephone
required
string <= 20 characters ^(\+\d)?(\(\d+\))?[\s\d]*(ext\.??[\s\d]*\d\s*...
Example: "0131 567 8910"

A contact telephone number for the case.

required
Array of objects

A list of subjects for the deeds in the case. The first version of the API will only allow a single registered title but an array must be given to allow for future changes.

Array
type
required
string
Value: "REGISTERED"

The subject type. The API will support only draft and registered titles; when REGISTERED is supplied this will be automatically translated to DRAFT if the title is a draft.

titleNumber
required
string [ 4 .. 11 ] characters ^[A-Z]{3}[0-9]{1,8}$
Example: "MID15313"

A land register title number. Must be a valid draft or registered title.

Responses

Request samples

Content type
application/json
{
  • "reference": "SMITH/2023/8",
  • "agent": {
    },
  • "subjects": [
    ]
}

Response samples

Content type
application/json
{}

Add a deed to an RLP case

Add a deed to an existing case. The case cannot be private and must belong to the organisation associated with the OAuth client ID.

Deeds can only be added to cases that have a single registered or draft title subject, but deeds over part added via the UI are ignored when adding a new deed with the API. The case need not have been created via the API. Currently, only dispositions, standard securities and discharges of standard security can be created using the API and the deed must be over the whole of a single title.

Authorizations:
OAuth2.0-Client-Credentials
path Parameters
caseId
required
string^RLP[\d]{2}[A-Z]{8}$
Example: RLP23MHWTHXCS

Case unique identifier. The pattern is documented here for information and may change without notice.

Request Body schema: application/json
deedType
required
string
Enum: "1" "11" "20"

Deed type identifier. 1 = Discharge of Standard Security, 11 = Disposition, 20 = Standard Security.

subjectExtent
required
string
Value: "REGISTERED_WHOLE"

The part of the case subject the deed relates to. In this version of the API, this must be REGISTERED_WHOLE, meaning the deed relates to the whole of a single registered or draft title.

securityId
string [ 1 .. 20 ] characters
Example: "b2JmdXNjYXRlZA"

Optional, permitted for discharges over registered titles only. This is the ID of the security to be discharged, retrieved from the title information endpoint. If not provided, the security must be selected in the UI.

mortgageNumbers
Array of strings <= 25 items [ items [ 1 .. 50 ] characters ]
Example: ["684-599-354"]

Optional, permitted for discharges over registered titles only. A list of mortgage numbers. If the discharge must be done on paper this information is discarded.

notificationEmails
Array of strings <= 4 items [ items <= 255 characters ]
Example: ["beth.harper@abcsolicitors.com"]

List of emails to receive notifications about this application. Optional; can be completed in the UI. Maximum 4 email addresses.

Array of DeedParty (object) or CreditorApplicant (object)

List of applicants. For a standard security, a single creditor applicant is required. For a discharge, granter applicants are not supported.

Array
One of
type
required
string
Enum: "NATURAL" "NON_NATURAL_UK" "NON_NATURAL"

The type of party.

prefix
any
Enum: "executor_of" "executors_of" "guardian_of" "guardians_of" "trustees_of" "..."
Example: "Doctor"

Optional party name prefix. Allowed prefix depends on the party type.
The list documented here is a sample. The following endpoints provide supported prefixes for each party type.
NATURAL: https://api.ros.gov.uk/v1/ref/core/person/name/prefix
NON_NATURAL_UK: https://api.ros.gov.uk/v1/ref/core/company/name/prefix/uk
NON_NATURAL: https://api.ros.gov.uk/v1/ref/core/company/name/prefix

firstName
string <= 255 characters
Example: "Iona"

Permitted and required for NATURAL parties only. The first/given name.

lastName
string <= 255 characters
Example: "MacLeod"

Permitted for required for NATURAL parties only. The family name/surname.

organisationName
string <= 255 characters
Example: "Bank of Money"

Permitted for and required for NON_NATURAL and NON_NATURAL_UK parties only. The company, trust or organisation name.

organisationNumber
string <= 255 characters
Example: "SC03849813"

Permitted for NON_NATURAL and NON_NATURAL_UK parties only. Required for NON_NATURAL_UK parties. Company or allocated number.

required
object (PartyAddress)
name
string <= 50 characters
Example: "3rd Floor, Meadowbank House"

Building name, floor, tenement flat number etc.

number
integer <= 99 characters
Example: 112

Numeric house number if available (tenement flat numbers e.g. 2F4 or 4/23 should be given in the name field)

street
string <= 80 characters
Example: "London Road"

Street name, business park name etc.

town
required
string <= 30 characters
Example: "Edinburgh"

Post town

postcode
string <= 8 characters
Example: "EH7 5GH"

UK or overseas postal or ZIP code

country
string <= 50 characters
Example: "UK"

Country

Array of objects (DeedParty)

List of granters.

Array
type
required
string
Enum: "NATURAL" "NON_NATURAL_UK" "NON_NATURAL"

The type of party.

prefix
any
Enum: "executor_of" "executors_of" "guardian_of" "guardians_of" "trustees_of" "..."
Example: "Doctor"

Optional party name prefix. Allowed prefix depends on the party type.
The list documented here is a sample. The following endpoints provide supported prefixes for each party type.
NATURAL: https://api.ros.gov.uk/v1/ref/core/person/name/prefix
NON_NATURAL_UK: https://api.ros.gov.uk/v1/ref/core/company/name/prefix/uk
NON_NATURAL: https://api.ros.gov.uk/v1/ref/core/company/name/prefix

firstName
string <= 255 characters
Example: "Iona"

Permitted and required for NATURAL parties only. The first/given name.

lastName
string <= 255 characters
Example: "MacLeod"

Permitted for required for NATURAL parties only. The family name/surname.

organisationName
string <= 255 characters
Example: "Bank of Money"

Permitted for and required for NON_NATURAL and NON_NATURAL_UK parties only. The company, trust or organisation name.

organisationNumber
string <= 255 characters
Example: "SC03849813"

Permitted for NON_NATURAL and NON_NATURAL_UK parties only. Required for NON_NATURAL_UK parties. Company or allocated number.

required
object (PartyAddress)
name
string <= 50 characters
Example: "3rd Floor, Meadowbank House"

Building name, floor, tenement flat number etc.

number
integer <= 99 characters
Example: 112

Numeric house number if available (tenement flat numbers e.g. 2F4 or 4/23 should be given in the name field)

street
string <= 80 characters
Example: "London Road"

Street name, business park name etc.

town
required
string <= 30 characters
Example: "Edinburgh"

Post town

postcode
string <= 8 characters
Example: "EH7 5GH"

UK or overseas postal or ZIP code

country
string <= 50 characters
Example: "UK"

Country

Responses

Request samples

Content type
application/json
{
  • "deedType": "1",
  • "subjectExtent": "REGISTERED_WHOLE",
  • "securityId": "b2JmdXNjYXRlZA",
  • "mortgageNumbers": [
    ],
  • "notificationEmails": [
    ],
  • "applicants": [
    ],
  • "granters": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "5bde84ac-933b-e49c-6edd-48bc13ae8fb3067c"
}