Submit an application API Technical guide

Use this service to provide data to HMLR for updating the register.

Warning These API endpoints are not currently live.

Version and Status

How to use the Submit an application API

To submit an application request, make an HTTP POST request to the application request endpoint, the body of which contains the information about the application using the application/json content type.

This endpoint will return an object containing a unique ID for the request, application_request_id, which is then used when fetching the status of the application. Any errors in the schema will be rejected as a 400 HTTP error. Any other validation errors will be returned in the application information response.

Notifications

Note: For general information, view the notifications API page.

During application submission, notifications will be available from the notifications API about changes that happen to the application. These notifications currently include:

APPLICATION_ACCEPTED_ON_DAY_LIST - the application has been accepted and is on the day list
APPLICATION_ACCEPTED_QUEUED_FOR_DAY_LIST - the application has been accepted and is queuing for the day list
APPLICATION_VALIDATION_FAILED - the application submission has failed
APPLICATION_ERROR - the application has not been added to the day list due to an error

The notifications will contain the following information:

APPLICATION_ACCEPTED_QUEUED_FOR_DAY_LIST, APPLICATION_VALIDATION_FAILED and APPLICATION_ERROR will contain the updated application status only
APPLICATION_ACCEPTED_ON_DAY_LIST will contain updated application status, the priority of the application and the HMLR reference for the accepted application

To get more detailed information about an application that caused the notification, use the Application information API. For example, after receiving an APPLICATION_VALIDATION_FAILED notification, use the Application information API to get a list of the validation errors.

Schemas

JSON schemas can be found below:

Validation rules

To pass validation, you must follow the guidance for implementing this API below.

SOAP migration guide

The structure has changed between the SOAP and REST APIs. Most fields retain their existing names, but some have changed, as noted below:

SOAP field	REST field	Comment
AddressForService	full_address
AP1WarningUnderstood	submission_warning_understood
ApplicationAffectsContent	scope	Field on `TitleScopeDetails` object
Applications	Transaction
CareOfReference		Care of reference should not be sent
CertifiedCopy	certification_statement_type	Field on `DocumentDetails.DocumentMetadata` object
ChargeDate	date	Field on `Charge` object
CompanyName	organisation_name	Field on `OverseasCompany`, `UKCompany` and `OtherOrganisation` objects
CompanyRegistrationNumber	company_number
ConveyancerName	full_name	Field on `OtherConveyancer` object
Dealing	REGISTER_UPDATE type	Service title type corresponds to the application type
DisclosableOveridingInterests	disclosable_overriding_interests	Field on `TitleDetails` object
DocumentNameContent	type	Field on `DocumentDetails` object
DXExchange	exchange_name	Field on `DxAddress` object
DXNumber	number	Field on `DxAddress` object
EmailAddress.Email	email	Field on `Address` object, where type is `Email`
IsApplicant	applicants[]	Array containing `PartyReferences` for applicants
LeaseExtension	DISPOSITIONARY_FIRST_LEASE	Service title type corresponds to the application type
LesseeTitles	TENANT_TITLE
LessorTitles	LANDLORD_TITLE
LocalAuthority		Local authority should not be sent
MessageID	Idempotency-Key	Idempotency-Key is a HTTP Header
NewLease	DISPOSITIONARY_FIRST_LEASE type	Service title type corresponds to the application type
NoMDRef		If the MDref is not sent, it is assumed the MDRef is not known and lender information must be provided
OverseasTerritory	incorporation_territory
PostalAddress	UKAddress	A type on the `Address` object
PostcodeOfProperty	postcode	Field on `UKAddress` object
Product.Email	email	Field on `ApplicationLodger` object
Reference	customer_reference
Reference	conveyancer_reference	Field on `OtherConveyancer` object
RoleType	Role	Field on `PartyRole` object
ServiceTitlesType	type	Field on `substantiveOrderV5Data` object
SortCode		Sort code should not be sent
TelephoneNumber	telephone	Field on `ApplicationLodger` object
TitleType	title_type	Changed from an object containing a title number to a enum on the `titleDetails` object
TransferOfPart	TRANSFER_OF_PART type	Service title type corresponds to the application type
UK-LLPRegistrationNumber	company_number

List of valid territories

When a party is an overseas company, you must provide the territory of incorporation. This territory must be one of the territories defined below:

Valid territories

Abu Dhabi, United Arab Emirates
Afghanistan
Ajman Free Zone, United Arab Emirates
Ajman, United Arab Emirates
Alabama, United States of America
Aland
Alaska, United States of America
Albania
Alberta, Canada
Alderney
Algeria
American Samoa
Andorra
Angola
Anguilla
Antarctica
Antigua & Barbuda
Antigua and Barbuda
Argentina
Arizona, United States of America
Arkansas, United States of America
Armenia
Aruba
Ascension Island
Australia
Australian Antarctic Territory
Austria
Azerbaijan
Azores
Bahamas
Bahrain
Bangladesh
Barbados
Belarus
Belau
Belgium
Belize
Benin
Bermuda
Bhutan
Bolivarian Republic of Venezuela
Bolivia
Bonaire
Bonaire, Sint Eustatius and Saba
Bosnia & Herzegovina
Bosnia and Herzegovina
Botswana
Bouvet Island
Brazil
British Antarctic Territory
British Colombia, Canada
British Indian Ocean Territory
British Virgin Islands
Brunei Darussalam
Bulgaria
Burkina Faso
Burundi
Cabo Verde
California, United States of America
Cambodia
Cameroon
Canada
Cape Verde
Carolina Islands
Cayman Islands
Central African Republic
Chad
Channel Islands
Chile
China
Christmas Island
Christmas Island (Indian Ocean)
Christmas Island (Pacific Ocean)
Cocos (Keeling) Islands
Cocos Islands
Colombia
Colorado, United States of America
Comoros
Congo
Connecticut, United States of America
Cook Islands
Costa Rica
Cote D'Ivoire
Cote D’‘Ivoire
Croatia
Cuba
Curacao
Cyprus
Czech Republic
Czechia
Delaware, United States of America
Democratic People’s Republic of Korea
Democratic Republic of Congo
Democratic Republic of the Congo
Denmark
Djibouti
Dominica
Dominican Republic
Dubai International Financial Centre, United Arab Emirates
Dubai Silicon Oasis, United Arab Emirates
Dubai, United Arab Emirates
East Timor
Ecuador
Egypt
Eire
El Salvador
Equatorial Guinea
Eritrea
Estonia
Eswatini
Ethiopia
Europe under the Treaty on European Union and the Treaty on the Functioning of the European Union
Falkland Islands
Faroe Islands
Federated States of Micronesia
Fiji
Finland
Florida, United States of America
France
French Guinea
French Polynesia
French Southern Antarctic Territory
Fujairah Media Free Zone, United Arab Emirates
Fujairah, United Arab Emirates
Fyr Macedonia
Gabon
Gambia
Georgia
Georgia, United States of America
Germany
Ghana
Gibraltar
Greece
Greenland
Grenada
Guadeloupe
Guam
Guatemala
Guernsey
Guinea
Guinea-Bissau
Guyana
Haiti
Hawaii, United States of America
Heard & Mcdonald Islands
Heard and Mcdonald Islands
Holy See
Honduras
Hong Kong
Hungary
Iceland
Idaho, United States of America
Illinois, United States of America
India
Indiana, United States of America
Indonesia
Iowa, United States of America
Iran
Iraq
Ireland
Isle of Man
Israel
Italy
Ivory Coast
Jamaica
Japan
Jebel Ali Free Zone, United Arab Emirates
Jersey
Jordan
Kansas, United States of America
Kazakhstan
Kentucky, United States of America
Kenya
Kiribati
Kosovo
Kuwait
Kyrgyzstan
Labuan
Labuan, Malaysia
Lao People’s Democratic Republic
Laos
Latvia
Lebanon
Lesotho
Liberia
Libya
Liechtenstein
Lithuania
Louisiana, United States of America
Luxembourg
Macao
Madagascar
Madeira Free Trade Zone
Maine, United States of America
Malawi
Malaysia
Maldives
Mali
Malta
Manitoba, Canada
Mariana Islands
Marshall Islands
Martinique
Maryland, United States of America
Massachusetts, United States of America
Mauritania
Mauritius
Mayotte
Mexico
Michigan, United States of America
Minnesota, United States of America
Mississippi, United States of America
Missouri, United States of America
Moldova
Monaco
Mongolia
Montana, United States of America
Montenegro
Montserrat
Morocco
Mozambique
Myanmar
Namibia
Nauru
Nauru Island
Nebraska, United States of America
Nepal
Netherland Antarctic Territory
Netherlands
Netherlands Antilles
Nevada, United States of America
Nevis
New Brunswick, Canada
New Caledonia
New Hampshire, United States of America
New Jersey, United States of America
New Mexico, United States of America
New York, United States of America
New Zealand
New Zealand Antarctic Territory
Newfoundland and Labrador, Canada
Nicaragua
Niger
Nigeria
Niue
Niue
Norfolk Island
North Carolina, United States of America
North Dakota, United States of America
North Macedonia
Northern Mariana Islands
Northwest Territories, Canada
Norway
Norwegian Antarctic Territory
Nova Scotia, Canada
Nunavut, Canada
Ohio, United States of America
Oklahoma, United States of America
Oman
Ontario, Canada
Oregon, United States of America
Pakistan
Palau
Palestine
Palestine Territory
Panama
Papua New Guinea
Paraguay
Pennsylvania, United States of America
Peoples Republic of Congo
Peru
Philippines
Pitcairn Island
Poland
Portugal
Prince Edward Island, Canada
Puerto Rico
Qatar
Quebec, Canada
Ras Al Khaimah Free Trade Zone, United Arab Emirates
Ras Al Khaimah, United Arab Emirates
Republic of Korea
Republic of Moldova
Reunion
Rhode Island, United States of America
Romania
Russian Federation
Rwanda
S Georgia and S Sandwich Islands
Saint Barthelemy
Saint Helena
Saint Kitts
Saint Lucia
Saint Martin
Saint Pierre and Miquelon
Saint Vincent & Grenadines
Saint Vincent and the Grenadines
Samoa
San Marino
Sao Tome & Principe
Sao Tome and Principe
Sark
Saskatchewan, Canada
Saudi Arabia
Scattered Islands
Senegal
Serbia
Serbia and Montenegro
Seychelles
Sharjah, United Arab Emirates
Sierra Leone
Singapore
Sint Eustatius and Saba
Sint Maarten
Slovakia
Slovenia
Solomon Islands
Somalia
South Africa
South Carolina, United States of America
South Dakota, United States of America
South Sudan
Spain
Spanish Territory of North Africa
Spitzbergen
Sri Lanka
St Barthelemy
St Helena
St Kitts & Nevis
St Lucia
St Martin
St Pierre and Miquelon
Sudan
Sultanate of Oman
Suriname
Svalbard and Jan Mayen
Swaziland
Sweden
Switzerland
Syria
Syrian Arab Republic
Tahiti
Taiwan
Taiwan, Province of China
Tajikistan
Tanzania
Tasmania
Tasmania, Australia
Tennessee, United States of America
Texas, United States of America
Thailand
The Bahamas
The Congo
The Democratic Republic of Korea
The Dominican Republic
The Peoples Republic of Korea
Tibet
Timor-Leste
Togo
Tokelau
Tonga
Trinidad and Tobago
Tristan Da Cunha
Tunisia
Turkey
Turkmenistan
Turks and Caicos Islands
Tuvalu
Uganda
Ukraine
Umm Al Quwain, United Arab Emirates
United Arab Emirates
United Kingdom
United Republic of Tanzania
United States Minor Outlying Islands
United States of America
Uruguay
Us Minor Outlying Islands
Us Virgin Islands
Utah, United States of America
Uzbekistan
Vanuatu
Vatican
Venezuela
Vermont, United States of America
Vietnam
Virginia, United States of America
Wallis and Futuna
Washington, United States of America
West Virginia, United States of America
Western Sahara
Wisconsin, United States of America
Wyoming, United States of America
Yemen
Yukon, Canada
Zambia
Zimbabwe

Transaction and document types

The application submission API accepts several transaction and document types that describe the desired outcome of the application. These types are defined in the schema in their shortened form, but full definitions of each type can be viewed below:

Transaction types

Transaction types
Code	Description
ADV1	First notice of adverse possession
ADV2	Adverse possession: notification
AGN	Agreed notice (AN1)
AML	Amalgamation
APLC	Appointment of liquidator (creditor’s voluntary winding up)
APLCO	Appointment of liquidator (compulsory winding up)
APLM	Appointment of liquidator (members’ voluntary winding up)
APR	Apportionment of rent
APT	Appointment of new trustee
ARC	Apportionment of rent charge
ASSTTP	Assent (Transfer of Part)
ASTC	Assent of charge
ASTT	Assent
ATP	Amendment to title plan
ATR	Rule 130 Alteration of Title Register
AUN	Amendment of unilateral notice (UN3)
BKN	Bankruptcy notice/Creditors’ notice
BKR	Bankruptcy restriction/Bankruptcy inhibition
C	Charge
CAG	Cancellation of notice (not unilateral) (CN1)
CANI	Cancellation of inhibition (RX3)
CANR	Cancellation of restriction (RX3)
CANU	Cancellation of unilateral notice (UN4)
CBKN	Cancellation of bankruptcy notice
CBKR	Cancellation of bankruptcy restriction
CCT	Cancellation of a caution (CCD)
CH2	Obligation to make further advances (CH2)
CH3	Agreed maximum amount of security (CH3)
CHOA	Charging order - Agreed notice (AN1)
CHOU	Charging order - Unilateral notice (UN1)
CHR	Cancellation of home rights (HR4)
CN	Change of name
CNC	Change of name - chargee
CNL	Cancellation of an unregistered noted lease (CN1)
COA	Change of address for service
COAC	Change of address for service - chargee
CON	Consolidation of charge
COP	Charge of part
CPD	Change of property description
CPVK	Compulsory purchase (property value known)
CPVU	Compulsory purchase (property value unknown)
CTD	Commonhold transitional dealing
CUR	Cancellation of notice of unregistered Rentcharge
DB	Determined boundary (DB)
DCLN	Disclaimer - notification
DCLV	Disclaimer - notice
DEB	Debenture
DFL1	New lease - other
DFL3	New lease - shared ownership
DFL4	New lease - right to buy or right to acquire
DFL5	Dispositionary first lease extension of a term
DFT	Defect in title s64(1) LRA 2002
DIS	Discharge of charge
DJP	Death of a joint proprietor
DL	Discontinuous lease - non-timeshare
DMR	Disapplication of restriction (RX2)
DOG	Deed of grant of easement
DP	Discharge of part
DSP	Death of a sole proprietor
DSS	Deed of substituted security
DTL	Discontinuous lease - timeshare
EX1	Exempt information document registration
EX3	Remove emption of document registration
EXR	Extinguishment of rentcharge
HR	Notice of home rights (HR1)
JP1	Removal of default Form A restriction
LCATCO	Lease closure - of assured tenancies following court order
LCBD	Lease closure - by disclaimer
LCBET	Lease closure - by effluxion of time
LCBN	Lease closure - by notice
LCF	Lease closure - forfeiture
LCMRE	Lease closure - merger with reversionary estate
LCOE	Lease closure - on enlargement
LCOF	Lease closure - on frustration
LCSD	Lease closure - surrender by deed (not for value or reverse premium)
LCSDM	Lease closure - surrender by deed
LCSDWT	Lease closure - surrender by deed with a transfer (not for value or reverse premium)
LCSDMWT	Lease closure - surrender by deed (together with transfer)
LCSOL	Lease closure - surrender by operation of law (not for value or reverse premium)
LCSOLM	Lease closure - surrender by operation of law
MDR	Modification of Restriction
NCT	Caution amendment, new cautioner
NDC	Notification of dissolution of company
NFR	Noting of an affecting franchise
NOE	Noting an easement
NOL	Noting a lease
NOPSC	Note overriding priority of a statutory charge
NPR	Noting of a profit
NRT	Notice of rentcharge
PC	Postponement of charge
PER	Personal covenants
PRO	Provisions
RC	Restrictive covenants - entry of
RE	Register Easement
RFN	Deed of rectification
RHR	Renewal of home rights (HR2)
ROCA	Release of covenants - agreed notice (AN1)
ROCC	Release of covenants - cancellation (CN1)
ROCU	Release of covenants - unilateral notice (UN1)
RNT	Overriding lease granted under s.19, Landlord & Tenant (Covenants) Act 1995
ROE	Release of easements
RRC	Registration of rent charge
RRD	Removal of a right to determine
RTM	Acquisition of right to manage
RUN	Removal of unilateral notice (UN2)
RXL	Form ll restriction entered - simple request
RXN	Restriction (non-standard wording) (RX1)
RXS	Restriction (standard wording) (RX1)
SBC	Sub charge
SHO	Shared ownership - additional share
SJT	Severance of joint tenancy (SEV, RX1)
SOT	Subdivision of title
STVC	Statutory vestings charge
STVL	Statutory vestings land
T	Transfer for value
TNV	Transfer (not for value or reverse premium)
TNVTP	Transfer (not for value or reverse premium) (Transfer of part)
TOC	Transfer of charge
TOSNV	Transfer of share (not for value or reverse premium)
TOSNVTP	Transfer of share (not for value or reverse premium) (Transfer of part)
TOSTP	Transfer of share for value (Transfer of part)
TOSV	Transfer of share for value
TPS	Transfer under power of sale
TPSTP	Transfer under power of sale (Transfer of part)
TRC	Termination of commonhold
TRM	Transfer by operation of law on death
TSCNV	Transfer subject to a charge (not for value or reverse premium)
TSCNVTP	Transfer subject to a charge (not for value or reverse premium) (Transfer of part)
TSCTP	Transfer subject to a charge for value (Transfer of part)
TSCV	Transfer subject to a charge for value (Transfer of part)
TTP	Transfer for value (Transfer of part)
TVR	Transfer for value RTB/RTA
TVRTP	Transfer for value RTB/RTA (Transfer of part)
UNN	Unilateral notice (UN1)
UPT	Upgrade class of title (UT1)
VC	Variation of charge
VLAN	Variation of lease - agreed notice (AN1)
VLAP	Deed of variation of a lease - not increasing the term of or adding new land to the extent demised
VLUN	Variation of lease - unilateral notice (UN1)
VO	Vesting order
VOC	Variation of covenants
VOCA	Variation of covenants - agreed notice (AN1)
VOCU	Variation of covenants - unilateral notice (UN1)
VOE	Variation of easements
VOEA	Variation of easements - agreed notice (AN1)
VOEU	Variation of easements - unilateral notice (UN1)
VRC	Variation of rent charge
WCT	Withdrawal of caution
WDR	Withdraw a restriction (RX4)

Document types

Document types
Code	Description
ABSTRACT	Abstract
ACKAPU	Adjudicator’s Letter Confirming a Court’s Decision (ACKAPU)
ADJAR	Adjudicator’s Letter of Refusal (ADJAR)
ADJREVU	Adjudicator’s Letter of Confirmation (ADJREVU)
ADMIN_LTRS	Letters of Administration
ADV1	Adverse possession: registration (ADV1)
ADV2	Adverse possession: notification (ADV2)
AGREEMENT	Agreement
AMS1	Application to use Application Management Service (AMS1)
AN1	AN1 Agreed notice
AP1	AP1 Application to change the register
APPL_FRM	Application Form
APPOINTMENT_OF_TRUSTEE	Deed of Appointment of New Trustee
AS1	AS1 registered title(s): assent of whole
AS2	AS2: Assent of Charge
AS3	AS3 Assent of Part
ASSENT	Assent
ASSIGNMENT	Assignment
BIRTH_CERT	Birth Certificate
BOUND_PLAN	Determined Boundary Plan
CC	CC
CCD	CCD Cancel caution against dealings
CERT_CON_CH	Original or certified copy of the certificate of incorporation of change of name issued by Companies House
CERT_DEATH	Certificate of Presumed Death
CERT_REG_CH	Certificate of registration issued by Companies House
CERT_RED_EX	Correctly certified and redacted exempt information document
CERT_S89	Certificate of Filing to Comply with s. 89 of the Insolvency Act 1987
CH1	CH1 Legal charge (mortgage) of a registered estate
CH2	CH2 Obligation to make further advances
CH3	CH3 Note agreed maximum amount of security
CHARGE	Charge
CHARG_ORD	Charging Order
CIVIL_CERT	Marriage/civil partnership certificate
CM2	Commonhold land: registered freehold termination (CM2)
CM5	Commonhold land: termination (CM5)
CM6	Commonhold successor: registration (CM6)
CN1	CN1 Cancel notice
CNFRM_DTMN_LTA_LGHA	Confirmation of determination of lease in accordance with the LTA 1954 or the LGHA 1989
CNFRM_NO_DEED_SUR	Confirmation that no deed of surrender has been entered into
CNFRM_NO_LTA_LGHA	Confirmation that neither the LTA 1954 nor the LGHA 1989 affect the lease
CNSNT_ADMIN_COURT	Consent of the administrator or the court (if lessee is in administration)
COMP_DOC	Company Documentation
CONSENT	Consent
CONST_COMP	Document(s) constituting the company
CONTR_RES	Contributory’s resolution appointing the liquidator
CONV_CERT	Conveyancer’s Certificate
CONV_CERT_DEATH	Conveyancer’s Certificate of the fact of death
CONVEYANCE	Conveyance
COR_CERT	Coroner’s Certificate
CORRES	Correspondence
COSR	Company search result
COURT_ORD	Court Order
CRALIQ	Company resolution appointing the liquidator
CRED_DEC	Creditor’s decision notice
CRED_RES	Creditor’s resolution appointing the liquidator
CRT_FORM_7	Certificate in Form 7
CRWALIQ	Company resolution that it be wound up and appointing the liquidator
DB	DB Determine the exact line of a boundary
DEATH_CERT	Death Certificate
DEC_AB_NULL_MARR	Decree absolute or nullity of marriage
DEED	Deed
DEED_POLL	Deed poll
DEED_REG_DIS	Deed which is a registrable disposition
DEED_SUR	Deed of Surrender
DISCHARGE	Discharge
DJP	DJP Death of joint proprietor
DL	Document List
DOP	Deed of postponement
DRIVING_LICENCE	Driving licence
DS1	DS1
DS2	DS2 Cancel entries relating to registered charge
DS3	DS3 Release of Part of the Land from a registered charge
DS3_SHORT	DS3
EOB	Evidence of bankruptcy
EOL	Evidence of liquidation
EVD_NO_RENEW	Evidence that any option to renew has not been, and cannot be, exercised
EVIDENCE	Evidence
EV_OV_NAME_CHANGE	Evidence of an overseas company name change
EX1	EX1 Exempt information document
EX1A	EX1A
EX3	EX3 Remove exemption of document
FORM_600	Companies House Form 600
FORM_600CH	Companies House Form 600CH
FORM_DI	Form DI
FORM_JO	Form JO (Trust Information)
FR1	FR1 Application for First Registration
GENDER_CERT	Gender recognition certificate
GVD	General vesting declaration
HR1	HR1 Notice of home rights
HR2	HR2 Renew notice of home rights
HR4	HR4 Cancel notice of home rights
ID1	ID1 - Verify identity: citizen
ID2	ID2 - Verify identity: body corporate
ID3	ID3 - Certificate of identity for a private individual
ID4	ID4 - Certificate of identity for a body corporate
ID5	ID5 - Certificate to be given by a conveyancer where a person’s identity has been verified by way of an online video call
ID_EV	Identity Evidence
ID_FRM	Identity Form
INDENTURE	Indenture
JP1	JP1 Letter
K17_OR_K18	Land Charge Search in Form K17 or K18
K20	Certificate of Cancellation of Bankruptcy Notice in Form K20
K22	Acknowledgement of Application for Cancellation of Bankruptcy Notice in Form K22
K3	HMLR Form K3
K4	HMLR Form K4
LEASE	Lease
LICENCE	Licence
LIQ01	Companies House Form LIQ01
LIQ_CERT_1	Liquidator’s certificate confirming liquidator’s appointment or that no resolution was passed nominating one
LIQ_CERT_2	Liquidator’s certificate that a meeting was held in accordance with s. 98(1) of the Insolvency Act 1986
LIQ_CERT_3	Liquidator’s certificate that appointment confirmed by a creditor’s qualifying decision procedure
LNDLD_CNSNT	Landlord’s consent
LONP	Letter or notice of postponement
LR_CORRES	LR Correspondence should only be used for copies of correspondence sent by HMLR
LTT	Land Transaction Tax
MARR_CERT	Marriage Certificate
MEMO	Memorandum
MORD	Ministerial order
MRTG_DEED	Mortgage Deed
NOD	Notice of disclaimer
ORD_DISS_NULL_CP	Order of dissolution or nullity of civil partnership
PASSPORT	Passport
PLAN	Plan
POA	Power of Attorney
PROBATE	Probate
PSS1	Application to use Pre-submission Enquiry Service (PSS1)
REVERS_INT	Examined Abstract of Reversionary Interest(s)
RN	Receipted Notice
RX1	RX1 Restriction
RX2	RX2 Disapply or modify restriction
RX3	RX3 Cancel restriction
RX4	RX4 Withdraw restriction
RXC	RXC Restriction: consent or certificate
SC	SC Note overriding priority of statutory charge
SDLT	Stamp Duty Land Tax
SEV	SEV Severance of Joint Tenancy
SHRF_RTN	Sheriff’s Return
SIDE_LTR	Side Letter
SOT	Statement Of Truth
SSALIQ	Appointment of Liquidator by The Secretary of State
STAT_DEC	Statutory Declaration
SUB_CHARGE	Sub Charge
TP1	TP1 Transfer of part of registered title(s)
TP2	TP2 Transfer of part under power of sale
TR1	TR1 Registered title(s): whole transfer
TR2	TR2 Registered title(s) under power of sale: whole transfer
TR4	TR4
TRANSFER	Transfer
TRUSTEE_RESOLUTION	Trustee resolution
UN1	UN1 Unilateral notice
UN2	UN2 Remove unilateral notice
UN3	UN3 Beneficiary of an existing unilateral notice
UN4	UN4 Cancel unilateral notice
UT1	UT1 Upgrade of title
VAR_CHARGE	Deed of Variation of Charge
VAR_COV	Deed of Variation of Covenants
VAR_EAS	Deed of Variation of Easements
VAR_LEASE	Deed of Variation of Lease
VESTING_ORDER	Vesting order
WCT	WCT Withdraw caution
WINDING_UP	Winding up order
WIT_STATE	Witness Statement

As well as the definition of each transaction/document, we have also provided a mapping, showing the required documents for each transaction type. There are three categories of documents that can be uploaded for a transaction:

Compulsory - this document is required for the transaction type
Either - at least one of the documents marked as Either must be submitted with the transaction
Suggested - these documents are not required, but are commonly attached alongside the transaction

For example, for an ADV1 transaction type, the following documents need to be uploaded:

An ADV1 document must be uploaded
At least one of an SOT or STAT_DEC document must be uploaded
COSR, EVIDENCE, PLAN and POA documents are not required, but may help when processing your application

During application submission, validation will be applied for each transaction to ensure the rules regarding the Compulsory and Either document types have been satisfied correctly:

Transaction/document mapping

Transaction/document mapping
Transaction type code	Document type code	Document class code
ADV1	ADV1	Compulsory
	SOT	Either
	STAT_DEC	Either
	COSR	Suggested
	EVIDENCE	Suggested
	PLAN	Suggested
	POA	Suggested
ADV2	ADV2	Compulsory
	EVIDENCE	Suggested
	PLAN	Suggested
	POA	Suggested
AGN	AN1	Compulsory
	CHARGE	Suggested
	CHARG_ORD	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	PLAN	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	TRANSFER	Suggested
	DEED	Suggested
	EVIDENCE	Suggested
	POA	Suggested
AML	CORRES	Suggested
APLC	CRWALIQ	Suggested
	FORM_600	Either
	FORM_600CH	Either
	CRED_DEC	Either
	CRED_RES	Either
	LIQ_CERT_2	Either
	LIQ_CERT_3	Either
	POA	Suggested
APLCO	WINDING_UP	Compulsory
	COURT_ORD	Suggested
	FORM_600	Suggested
	FORM_600CH	Suggested
	CRED_RES	Suggested
	CONTR_RES	Suggested
	LIQ_CERT_1	Suggested
	SSALIQ	Suggested
	POA	Suggested
APLM	CERT_S89	Compulsory
	LIQ01	Compulsory
	FORM_600	Either
	FORM_600CH	Either
	CRALIQ	Either
	POA	Suggested
APR	DEED	Either
	TRANSFER	Either
	MORD	Either
	POA	Suggested
APT	TRANSFER	Either
	TRUSTEE_RESOLUTION	Either
	VESTING_ORDER	Either
	APPOINTMENT_OF_TRUSTEE	Either
	CONSENT	Suggested
	CONV_CERT	Suggested
ARC	DEED	Either
	EVIDENCE	Either
	POA	Suggested
	RXC	Suggested
	TP1	Either
ASSTTP	AS3	Compulsory
	ADMIN_LTRS	Either
	PROBATE	Either
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	DEATH_CERT	Suggested
ASTC	AS2	Compulsory
	CONV_CERT	Either
	COURT_ORD	Either
	ADMIN_LTRS	Either
	PROBATE	Either
	DEATH_CERT	Suggested
ASTT	AS1	Compulsory
	PROBATE	Either
	ADMIN_LTRS	Either
	CONV_CERT	Suggested
	COURT_ORD	Suggested
ATP	CORRES	Suggested
	EVIDENCE	Suggested
	PLAN	Suggested
	POA	Suggested
ATR	CORRES	Either
	EVIDENCE	Suggested
	SOT	Either
	STAT_DEC	Either
AUN	UN3	Compulsory
	POA	Suggested
BKN	K3	Either
	K4	Either
	COURT_ORD	Suggested
	POA	Suggested
BKR	RX1	Compulsory
	POA	Suggested
C	CH1	Either
	MRTG_DEED	Either (Compulsory if mdref is provided)
	CH2	Suggested
	RX1	Suggested
CAG	CN1	Compulsory
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	PLAN	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	EVIDENCE	Suggested
	POA	Suggested
CANI	RX3	Compulsory
	POA	Suggested
CANR	RX3	Compulsory
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	PLAN	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	EVIDENCE	Suggested
	POA	Suggested
CANU	UN4	Compulsory
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	PLAN	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	EVIDENCE	Suggested
	POA	Suggested
CBKN	COURT_ORD	Either
	K22	Either
	ADJAR	Either
	ACKAPU	Either
	ADJREVU	Either
	K20	Either
	POA	Suggested
CBKR	COURT_ORD	Either
	EVIDENCE	Either
	POA	Suggested
CCT	CCD	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
CH2	CH2	Compulsory
	POA	Suggested
CH3	CH3	Compulsory
	POA	Suggested
CHOA	AN1	Compulsory
	COURT_ORD	Suggested
CHOU	UN1	Compulsory
	COURT_ORD	Suggested
CHR	HR4	Compulsory
	POA	Suggested
CN	CORRES	Compulsory
	BIRTH_CERT	Either
	CONV_CERT	Either
	DEED_POLL	Either
	DRIVING_LICENCE	Either
	EVIDENCE	Either
	GENDER_CERT	Either
	CIVIL_CERT	Either
	PASSPORT	Either
	SOT	Either
	STAT_DEC	Either
	POA	Suggested
CNC	CORRES	Compulsory
	BIRTH_CERT	Either
	CONV_CERT	Either
	DEED_POLL	Either
	DRIVING_LICENCE	Either
	EVIDENCE	Either
	GENDER_CERT	Either
	CIVIL_CERT	Either
	PASSPORT	Either
	SOT	Either
	STAT_DEC	Either
	POA	Suggested
CNL	CN1	Compulsory
	POA	Suggested
COA	CORRES	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
COAC	CORRES	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
CON	CC	Compulsory
COP	CH1	Either
	MRTG_DEED	Either
	CH2	Suggested
	RX1	Suggested
CPD	CORRES	Either
	EVIDENCE	Either
	POA	Suggested
CPVK	DEED_POLL	Either
	GVD	Either
CPVU	DEED_POLL	Either
	GVD	Either
CTD	CM2	Compulsory
	POA	Suggested
CUR	CN1	Compulsory
	EVIDENCE	Compulsory
	POA	Suggested
DB	BOUND_PLAN	Compulsory
	DB	Compulsory
	POA	Suggested
DCLN	EVIDENCE	Compulsory
	POA	Suggested
DCLV	EVIDENCE	Compulsory
	POA	Suggested
DEB	AN1	Suggested
	CH2	Suggested
	DEBENTURE	Compulsory
	RX1	Suggested
	RXC	Suggested
	UN1	Suggested
DFL1	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
DFL3	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
DFL4	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
DFL5	LEASE	Either
	VAR_LEASE	Either
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	SDLT	Suggested
	LTT	Suggested
DFT	EVIDENCE	Suggested
	POA	Suggested
DIS	DS1	Compulsory (When `discharge_submission_type` is `ATTACHED`)
DJP	DJP	Compulsory
	DEATH_CERT	Either
	PROBATE	Either
	CERT_DEATH	Either
	CONV_CERT	Either
	COR_CERT	Either
	ADMIN_LTRS	Either
	POA	Suggested
DL	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
DMR	RX2	Compulsory
	POA	Suggested
DOG	DEED	Compulsory
	CONSENT	Suggested
	CONV_CERT	Suggested
	POA	Suggested
DP	DS1	Compulsory
DSP	DEATH_CERT	Either
	PROBATE	Either
	CERT_DEATH	Either
	CONV_CERT	Either
	COR_CERT	Either
	ADMIN_LTRS	Either
	POA	Suggested
DSS	CH2	Suggested
	DEED	Compulsory
	EVIDENCE	Suggested
	RX1	Suggested
	RXC	Suggested
DTL	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
EX1	CERT_RED_EX	Compulsory
	CORRES	Suggested
	EVIDENCE	Suggested
	EX1	Compulsory
	EX1A	Compulsory
EX3	BIRTH_CERT	Suggested
	CIVIL_CERT	Suggested
	CONV_CERT	Suggested
	DEC_AB_NULL_MARR	Suggested
	DEED_POLL	Suggested
	DRIVING_LICENCE	Suggested
	EX3	Compulsory
	GENDER_CERT	Suggested
	ORD_DISS_NULL_CP	Suggested
	PASSPORT	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
EXR	CN1	Compulsory
	EVIDENCE	Compulsory
	POA	Suggested
HR	HR1	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
JP1	JP1	Compulsory
LCATCO	COURT_ORD	Either
	CONV_CERT	Either
	STAT_DEC	Either
	SHRF_RTN	Either
LCBD	NOD	Compulsory
	EOB	Either
	EOL	Either
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCBET	CNFRM_DTMN_LTA_LGHA	Either
	CNFRM_NO_LTA_LGHA	Either
	CN1	Suggested
	EVD_NO_RENEW	Suggested
LCBN	RN	Either
	CONV_CERT	Either
	STAT_DEC	Either
LCF	COURT_ORD	Either
	CONV_CERT	Either
	STAT_DEC	Either
	CNSNT_ADMIN_COURT	Suggested
LCMRE	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCOE	FR1	Compulsory
	DEED_REG_DIS	Compulsory
LCOF	EVIDENCE	Compulsory
LCSD	DEED_SUR	Either
	LNDLD_CNSNT	Either
	TR1	Either
	TP1	Either
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCSDM	DEED_SUR	Either
	TR1	Either
	TP1	Either
	LNDLD_CNSNT	Either
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCSDMWT	DEED_SUR	Suggested
	LNDLD_CNSNT	Suggested
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCSDWT	DEED_SUR	Suggested
	LNDLD_CNSNT	Suggested
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
LCSOL	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	CNFRM_NO_DEED_SUR	Suggested
LCSOLM	STAT_DEC	Suggested
	CNFRM_NO_DEED_SUR	Suggested
	CN1	Suggested
	DS1	Suggested
	DS3	Suggested
	HR4	Suggested
	RX3	Suggested
	RX4	Suggested
	UN2	Suggested
	UN4	Suggested
	SOT	Suggested
MDR	RX2	Compulsory
	POA	Suggested
NCT	EVIDENCE	Compulsory
	POA	Suggested
NDC	CORRES	Suggested
	POA	Suggested
NFR	AN1	Either
	UN1	Either
	EVIDENCE	Suggested
	POA	Suggested
NOE	DEED	Compulsory
	CONV_CERT	Suggested
	POA	Suggested
NOL	LEASE	Compulsory
	AN1	Either
	UN1	Either
	CONSENT	Suggested
	CONV_CERT	Suggested
	POA	Suggested
NOPSC	EVIDENCE	Suggested
	PLAN	Suggested
	SC	Compulsory
NPR	EVIDENCE	Suggested
	POA	Suggested
NRT	AN1	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
PC	DOP	Either
	LONP	Either
	POA	Suggested
PER	DEED	Suggested
	POA	Suggested
PRO	DEED	Suggested
	POA	Suggested
RC	DEED	Suggested
	POA	Suggested
RE	AN1	Compulsory
	EVIDENCE	Suggested
	CHARGE	Suggested
	CHARG_ORD	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	COURT_ORD	Suggested
	DEED	Suggested
	PLAN	Suggested
	POA	Suggested
	SOT	Suggested
	STAT_DEC	Suggested
	TRANSFER	Suggested
	RXC	Suggested
RFN	DEED	Suggested
	CONV_CERT	Suggested
	EVIDENCE	Suggested
	POA	Suggested
RHR	HR2	Compulsory
	POA	Suggested
RNT	LEASE	Compulsory
	SDLT	Suggested
	LTT	Suggested
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
ROCA	AN1	Compulsory
	DEED	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
ROCC	CN1	Compulsory
	DEED	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
ROCU	UN1	Compulsory
	DEED	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
ROE	DEED	Compulsory
	CONV_CERT	Suggested
	EVIDENCE	Suggested
	POA	Suggested
RRC	DEED	Either
	EVIDENCE	Suggested
	LEASE	Either
	POA	Suggested
	RXC	Suggested
	TP1	Either
RRD	EVIDENCE	Suggested
	POA	Suggested
RTM	EVIDENCE	Either
	CONV_CERT	Either
	POA	Suggested
RUN	UN2	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
RXL	RX1	Compulsory
	CONSENT	Suggested
	EVIDENCE	Suggested
	POA	Suggested
RXN	RX1	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
RXS	RX1	Compulsory
	CHARG_ORD	Suggested
	CONSENT	Suggested
	SEV	Suggested
	EVIDENCE	Suggested
	POA	Suggested
SBC	MRTG_DEED	Compulsory
SHO	MEMO	Either
	DEED	Either
	POA	Suggested
SJT	RX1	Either
	SEV	Either
	POA	Suggested
SOT	CORRES	Suggested
	EVIDENCE	Suggested
	PLAN	Compulsory
STVC	EVIDENCE	Compulsory
	COR_CERT	Suggested
	POA	Suggested
STVL	EVIDENCE	Compulsory
	COR_CERT	Suggested
	POA	Suggested
T	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	SDLT	Suggested
	LTT	Suggested
	PROBATE	Suggested
TNV	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TNVTP	TP1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TOC	TR4	Compulsory
	COMP_DOC	Suggested
	CONV_CERT	Suggested
	CONSENT	Suggested
TOSNV	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TOSNVTP	TP1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TOSTP	TP1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TOSV	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TPS	TR2	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TPSTP	TP2	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TRC	CM5	Either
	CM6	Either
	COURT_ORD	Suggested
	POA	Suggested
TRM	ADMIN_LTRS	Either
	PROBATE	Either
	TR1	Suggested
	CONV_CERT	Suggested
	CONSENT	Suggested
	FORM_JO	Suggested
	CERT_DEATH	Suggested
	COR_CERT	Suggested
	DEATH_CERT	Suggested
TSCNV	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TSCNVTP	TP1	Compulsory
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TSCTP	TP1	Compulsory
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
TSCV	TR1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	FORM_JO	Suggested
	DEATH_CERT	Suggested
	CIVIL_CERT	Suggested
	PROBATE	Suggested
TTP	TP1	Compulsory
	COMP_DOC	Suggested
	CONSENT	Suggested
	CONV_CERT	Suggested
	PLAN	Suggested
	SDLT	Suggested
	LTT	Suggested
TVR	TR1	Compulsory
	CONV_CERT	Suggested
	CONSENT	Suggested
	FORM_JO	Suggested
TVRTP	TP1	Compulsory
	CONV_CERT	Suggested
	CONSENT	Suggested
	FORM_JO	Suggested
UNN	UN1	Compulsory
	DEED	Suggested
	EVIDENCE	Suggested
	COURT_ORD	Suggested
	POA	Suggested
UPT	UT1	Compulsory
	EVIDENCE	Suggested
	REVERS_INT	Suggested
	K17_OR_K18	Suggested
	CONSENT	Suggested
	CONVEYANCE	Suggested
	CONV_CERT	Suggested
	LEASE	Suggested
	POA	Suggested
VC	VAR_CHARGE	Compulsory
	CONV_CERT	Suggested
	POA	Suggested
VLAN	AN1	Compulsory
	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
VLAP	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
VLUN	UN1	Compulsory
	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
	LEASE	Suggested
	POA	Suggested
VC	VAR_CHARGE	Compulsory
	CONV_CERT	Suggested
	POA	Suggested
VLAN	AN1	Compulsory
	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
VLAP	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
VLUN	UN1	Compulsory
	COURT_ORD	Either
	VAR_LEASE	Either
	SIDE_LTR	Either
	POA	Suggested
VO	COURT_ORD	Compulsory
VOC	COURT_ORD	Either
	VAR_COV	Either
	POA	Suggested
VOCA	AN1	Compulsory
	COURT_ORD	Either
	VAR_COV	Either
	POA	Suggested
VOCU	UN1	Compulsory
	COURT_ORD	Either
	VAR_COV	Either
	POA	Suggested
VOE	VAR_EAS	Compulsory
	POA	Suggested
VOEA	VAR_EAS	Compulsory
	AN1	Compulsory
	POA	Suggested
VOEU	VAR_EAS	Compulsory
	UN1	Compulsory
	POA	Suggested
VRC	DEED	Compulsory
	EVIDENCE	Suggested
	POA	Suggested
	RXC	Suggested
WCT	WCT	Compulsory
	POA	Suggested
WDR	RX4	Compulsory
	POA	Suggested

Valid transaction types per application type

For each application type (REGISTER_UPDATE, DISPOSITIONARY_FIRST_LEASE, TRANSFER_OF_PART and REMOVE_JP1), only certain transaction types can be supplied. The sections below detail which transaction types are valid for each application type.

Valid transaction types

`REGISTER_UPDATE`

ADV1 - First notice of adverse possession
ADV2 - Adverse possession: notification
AGN - Agreed notice (AN1)
APLC - Appointment of liquidator (creditor’s voluntary winding up)
APLCO - Appointment of liquidator (compulsory winding up)
APLM - Appointment of liquidator (members’ voluntary winding up)
APR - Apportionment of rent
APT - Appointment of new trustee
ASTC - Assent of charge
ATP - Amendment to title plan
AUN - Amendment of unilateral notice (UN3)
BKN - Bankruptcy notice/Creditors’ notice
BKR - Bankruptcy restriction/Bankruptcy inhibition
C - Charge
CAG - Cancellation of notice (not unilateral) (CN1)
CANI - Cancellation of inhibition (RX3)
CANR - Cancellation of restriction (RX3)
CANU - Cancellation of unilateral notice (UN4)
CBKN - Cancellation of bankruptcy notice
CBKR - Cancellation of bankruptcy restriction
CCT - Cancellation of a caution (CCD)
CH2 - Obligation to make further advances (CH2)
CH3 - Agreed maximum amount of security (CH3)
CHOA - Charging order - Agreed notice (AN1)
CHOU - Charging order - Unilateral notice (UN1)
CHR - Cancellation of home rights (HR4)
CN - Change of name
CNC - Change of name - chargee
CNL - Cancellation of an unregistered noted lease (CN1)
COA - Change of address for service
COAC - Change of address for service - chargee
CON - Consolidation of charge
COP - Charge of part
CPD - Change of property description
CPVK - Compulsory purchase (property value known)
CTD - Commonhold transitional dealing
CUR - Cancellation of notice of unregistered Rentcharge
DB - Determined boundary (DB)
DCLN - Disclaimer - notification
DCLV - Disclaimer - notice
DFL1 - New lease - other
DFT - Defect in title s64(1) LRA 2002
DIS - Discharge of charge
DJP - Death of a joint proprietor
DL - Discontinuous lease - non-timeshare
DMR - Disapplication of restriction (RX2)
DOG - Deed of grant of easement
DP - Discharge of part
DSP - Death of a sole proprietor
JP1 - Removal of default Form A restriction
LCATCO - Lease closure - of assured tenancies following court order
LCBD - Lease closure - by disclaimer
LCBET - Lease closure - by effluxion of time
LCBN - Lease closure - by notice
LCF - Lease closure - forfeiture
LCMRE - Lease closure - merger with reversionary estate
LCOE - Lease closure - on enlargement
LCOF - Lease closure - on frustration
LCSD - Lease closure - surrender by deed (not for value or reverse premium)
LCSDM - Lease closure - surrender by deed
LCSDMWT - Lease closure - surrender by deed (together with transfer)
LCSDWT - Lease closure - surrender by deed with a transfer (not for value or reverse premium)
LCSOL - Lease closure - surrender by operation of law (not for value or reverse premium)
LCSOLM - Lease closure - surrender by operation of law
MDR - Modification of Restriction
NCT - Caution amendment
NDC - Notification of dissolution of company
NFR - Noting of an affecting franchise
NOE - Noting an easement
NOL - Noting a lease
NPR - Noting of a profit
NRT - Notice of rentcharge
PC - Postponement of charge
PRO - Provisions
RC - Restrictive covenants - entry of
RFN - Deed of rectification
RHR - Renewal of home rights (HR2)
RNT - Overriding lease granted under s.19
ROCA - Release of covenants - agreed notice (AN1)
ROCC - Release of covenants - cancellation (CN1)
ROCU - Release of covenants - unilateral notice (UN1)
ROE - Release of easements
RRD - Removal of a right to determine
RTM - Acquisition of right to manage
RUN - Removal of unilateral notice (UN2)
RXL - Form || restriction entered - simple request
RXN - Restriction (non-standard wording) (RX1)
RXS - Restriction (standard wording) (RX1)
SBC - Sub charge
SHO - Shared ownership - additional share
SJT - Severance of joint tenancy (SEV)
STVC - Statutory vestings charge
STVL - Statutory vestings land
T - Transfer for value
TNV - Transfer (not for value or reverse premium)
TOC - Transfer of charge
TOSNV - Transfer of share (not for value or reverse premium)
TOSV - Transfer of share for value
TPS - Transfer under power of sale
TRC - Termination of commonhold
TRM - Transfer by operation of law on death
TSCNV - Transfer subject to a charge (not for value or reverse premium)
TSCV - Transfer subject to a charge for value
TVR - Transfer for value RTB/RTA
UNN - Unilateral notice (UN1)
UPT - Upgrade class of title (UT1)
VC - Variation of charge
VLAN - Variation of lease - agreed notice (AN1)
VLAP - Deed of variation of a lease - not increasing the term of or adding new land to the extent demised
VLUN - Variation of lease - unilateral notice (UN1)
VO - Vesting order
VOC - Variation of covenants
VOCA - Variation of covenants - agreed notice (AN1)
VOCU - Variation of covenants - unilateral notice (UN1)
VOE - Variation of easements
VOEA - Variation of easements - agreed notice (AN1)
VOEU - Variation of easements - unilateral notice (UN1)
WCT - Withdrawal of caution
WDR - Withdraw a restriction (RX4)

`TRANSFER_OF_PART`

ADV1 - First notice of adverse possession
ADV2 - Adverse possession: notification
AGN - Agreed notice (AN1)
APLM - Appointment of liquidator (members’ voluntary winding up)
APR - Apportionment of rent
ASSTTP - Assent (Transfer of Part)
C - Charge
CAG - Cancellation of notice (not unilateral) (CN1)
CANI - Cancellation of inhibition (RX3)
CANR - Cancellation of restriction (RX3)
CANU - Cancellation of unilateral notice (UN4)
CBKN - Cancellation of bankruptcy notice
CBKR - Cancellation of bankruptcy restriction
CCT - Cancellation of a caution (CCD)
CH2 - Obligation to make further advances (CH2)
CH3 - Agreed maximum amount of security (CH3)
CHOA - Charging order - Agreed notice (AN1)
CHOU - Charging order - Unilateral notice (UN1)
CHR - Cancellation of home rights (HR4)
CNL - Cancellation of an unregistered noted lease (CN1)
CON - Consolidation of charge
COP - Charge of part
CPVU - Compulsory purchase (property value unknown)
CTD - Commonhold transitional dealing
CUR - Cancellation of notice of unregistered Rentcharge
DB - Determined boundary (DB)
DCLN - Disclaimer - notification
DFL1 - New lease - other
DFT - Defect in title s64(1) LRA 2002
DIS - Discharge of charge
DL - Discontinuous lease - non-timeshare
DMR - Disapplication of restriction (RX2)
DOG - Deed of grant of easement
DP - Discharge of part
DSP - Death of a sole proprietor
LCATCO - Lease closure - of assured tenancies following court order
LCBD - Lease closure - by disclaimer
LCBET - Lease closure - by effluxion of time
LCF - Lease closure - forfeiture
LCSDWT - Lease closure - surrender by deed with a transfer (not for value or reverse premium)
LCSOL - Lease closure - surrender by operation of law (not for value or reverse premium)
LCSOLM - Lease closure - surrender by operation of law
MDR - Modification of Restriction
NFR - Noting of an affecting franchise
NOE - Noting an easement
NOL - Noting a lease
NPR - Noting of a profit
NRT - Notice of rentcharge
PRO - Provisions
RC - Restrictive covenants - entry of
RFN - Deed of rectification
RNT - Overriding lease granted under s.19
ROCC - Release of covenants - cancellation (CN1)
ROCU - Release of covenants - unilateral notice (UN1)
ROE - Release of easements
RRD - Removal of a right to determine
RUN - Removal of unilateral notice (UN2)
RXL - Form || restriction entered - simple request
RXN - Restriction (non-standard wording) (RX1)
RXS - Restriction (standard wording) (RX1)
SBC - Sub charge
SJT - Severance of joint tenancy (SEV)
STVC - Statutory vestings charge
STVL - Statutory vestings land
TNVTP - Transfer (not for value or reverse premium) (Transfer of part)
TOSNVTP - Transfer of share (not for value or reverse premium) (Transfer of part)
TOSTP - Transfer of share for value (Transfer of part)
TPSTP - Transfer under power of sale (Transfer of part)
TRC - Termination of commonhold
TSCNVTP - Transfer subject to a charge (not for value or reverse premium) (Transfer of part)
TSCVTP - Transfer subject to a charge for value (Transfer of part)
TTP - Transfer for value (Transfer of part)
TVRTP - Transfer for value RTB/RTA (Transfer of part)
UNN - Unilateral notice (UN1)
UPT - Upgrade class of title (UT1)
VC - Variation of charge
VLAN - Variation of lease - agreed notice (AN1)
VLAP - Deed of variation of a lease - not increasing the term of or adding new land to the extent demised
VLUN - Variation of lease - unilateral notice (UN1)
VO - Vesting order
VOC - Variation of covenants
VOCA - Variation of covenants - agreed notice (AN1)
VOCU - Variation of covenants - unilateral notice (UN1)
VOE - Variation of easements
VOEA - Variation of easements - agreed notice (AN1)
VOEU - Variation of easements - unilateral notice (UN1)
WCT - Withdrawal of caution
WDR - Withdraw a restriction (RX4)

`DISPOSITIONARY_FIRST_LEASE`

New leases

ADV1 - First notice of adverse possession
AGN - Agreed notice (AN1)
AUN - Amendment of unilateral notice (UN3)
BKR - Bankruptcy restriction/Bankruptcy inhibition
C - Charge
CAG - Cancellation of notice (not unilateral) (CN1)
CANI - Cancellation of inhibition (RX3)
CANR - Cancellation of restriction (RX3)
CANU - Cancellation of unilateral notice (UN4)
CBKN - Cancellation of bankruptcy notice
CBKR - Cancellation of bankruptcy restriction
CCT - Cancellation of a caution (CCD)
CH2 - Obligation to make further advances (CH2)
CH3 - Agreed maximum amount of security (CH3)
CHOA - Charging order - Agreed notice (AN1)
CHOU - Charging order - Unilateral notice (UN1)
CHR - Cancellation of home rights (HR4)
CN - Change of name
CNC - Change of name- chargee
CNL - Cancellation of an unregistered noted lease (CN1)
COA - Change of address for service
COAC - Change of address for service - chargee
COP - Charge of part
CUR - Cancellation of notice of unregistered Rentcharge
DCLV - Disclaimer - notice
DFL1 - New lease - other
DFL3 - New lease - shared ownership
DFL4 - New lease - right to buy or right to acquire
DFT - Defect in title s64(1) LRA 2002
DIS - Discharge of charge
DJP - Death of a joint proprietor
DMR - Disapplication of restriction (RX2)
DOG - Deed of grant of easement
DP - Discharge of part
DSP - Death of a sole proprietor
DTL - Discontinuous lease - timeshare
HR - Notice of home rights (HR1)
LCBD - Lease closure - by disclaimer
LCBN - Lease closure - by notice
LCF - Lease closure - forfeiture
LCMRE - Lease closure - merger with reversionary estate
LCOE - Lease closure - on enlargement
LCSD - Lease closure - surrender by deed (not for value or reverse premium)
LCSDM - Lease closure - surrender by deed
LCSDMWT - Lease closure - surrender by deed (together with transfer)
LCSOL - Lease closure - surrender by operation of law (not for value or reverse premium)
MDR - Modification of Restriction
NDC - Notification of dissolution of company
NFR - Noting of an affecting franchise
NOL - Noting a lease
NPR - Noting of a profit
NRT - Notice of rentcharge
PC - Postponement of charge
PER - Personal covenants
PRO - Provisions
RC - Restrictive covenants - entry of
RFN - Deed of rectification
RHR - Renewal of home rights (HR2)
RNT - Overriding lease granted under s.19
ROCA - Release of covenants - agreed notice (AN1)
ROCC - Release of covenants - cancellation (CN1)
ROCU - Release of covenants - unilateral notice (UN1)
ROE - Release of easements
RRD - Removal of a right to determine
RUN - Removal of unilateral notice (UN2)
RXN - Restriction (non-standard wording) (RX1)
RXS - Restriction (standard wording) (RX1)
SBC - Sub charge
SJT - Severance of joint tenancy (SEV)
UNN - Unilateral notice (UN1)
UPT - Upgrade class of title (UT1)
VC - Variation of charge
VLAN - Variation of lease - agreed notice (AN1)
VLAP - Deed of variation of a lease - not increasing the term of or adding new land to the extent demised
VLUN - Variation of lease - unilateral notice (UN1)
VOC - Variation of covenants
VOCA - Variation of covenants - agreed notice (AN1)
VOCU - Variation of covenants - unilateral notice (UN1)
VOE - Variation of easements
VOEA - Variation of easements - agreed notice (AN1)
VOEU - Variation of easements - unilateral notice (UN1)
WCT - Withdrawal of caution
WDR - Withdraw a restriction (RX4)

Lease extensions

For a lease extension application, the DFL5 (Dispositionary first lease extension of a term) transaction type must be used.

ADV1 - First notice of adverse possession
AGN - Agreed notice (AN1)
APLC - Appointment of liquidator (creditor’s voluntary winding up)
APLCO - Appointment of liquidator (compulsory winding up)
APLM - Appointment of liquidator (members’ voluntary winding up)
AUN - Amendment of unilateral notice (UN3)
C - Charge
CAG - Cancellation of notice (not unilateral) (CN1)
CANI - Cancellation of inhibition (RX3)
CANR - Cancellation of restriction (RX3)
CANU - Cancellation of unilateral notice (UN4)
CBKN - Cancellation of bankruptcy notice
CBKR - Cancellation of bankruptcy restriction
CCT - Cancellation of a caution (CCD)
CH3 - Agreed maximum amount of security (CH3)
CHOA - Charging order - Agreed notice (AN1)
CHOU - Charging order - Unilateral notice (UN1)
CHR - Cancellation of home rights (HR4)
CN - Change of name
CNC - Change of name- chargee
CNL - Cancellation of an unregistered noted lease (CN1)
COA - Change of address for service
COAC - Change of address for service - chargee
COP - Charge of part
CUR - Cancellation of notice of unregistered Rentcharge
DCLN - Disclaimer - notification
DCLV - Disclaimer - notice
DFL1 - New lease - other
DFL5 - Dispositionary first lease extension of a term
DFT - Defect in title s64(1) LRA 2002
DIS - Discharge of charge
DJP - Death of a joint proprietor
DL - Discontinuous lease - non-timeshare
DMR - Disapplication of restriction (RX2)
DOG - Deed of grant of easement
DP - Discharge of part
DSP - Death of a sole proprietor
EXR - Extinguishment of rentcharge
LCBD - Lease closure - by disclaimer
NRT - Notice of rentcharge
PRO - Provisions
RFN - Deed of rectification
RNT - Overriding lease granted under s.19
ROCC - Release of covenants - cancellation (CN1)
ROCU - Release of covenants - unilateral notice (UN1)
ROE - Release of easements
RRD - Removal of a right to determine
RUN - Removal of unilateral notice (UN2)
RXN - Restriction (non-standard wording) (RX1)
RXS - Restriction (standard wording) (RX1)
SBC - Sub charge
STVC - Statutory vestings charge
STVL - Statutory vestings land
UNN - Unilateral notice (UN1)
UPT - Upgrade class of title (UT1)
VC - Variation of charge
VLAN - Variation of lease - agreed notice (AN1)
VLUN - Variation of lease - unilateral notice (UN1)
VO - Vesting order
VOC - Variation of covenants
VOCA - Variation of covenants - agreed notice (AN1)
VOCU - Variation of covenants - unilateral notice (UN1)
VOE - Variation of easements
VOEA - Variation of easements - agreed notice (AN1)
VOEU - Variation of easements - unilateral notice (UN1)
WDR - Withdraw a restriction (RX4)

`REMOVE_JP1`

The only valid transaction type for the REMOVE_JP1 application type is JP1. This must be the only transaction, and there must only be a single JP1 transaction per application.

Additional transaction details

For certain transaction types, more detailed information is needed (via the Transaction.details field). This field can be one of several different types:

Transfer (dates must not be in the future)
Charge (dates must not be in the future)
Discharge
AmountDetails

The data below details which transactions require which details type. If a transaction is not listed, it does not require additional details.

Transfer

T - Transfer for value
TNV - Transfer (not for value or reverse premium)
TOSNV - Transfer of share (not for value or reverse premium)
TSCNV - Transfer subject to a charge (not for value or reverse premium)
TSCV - Transfer subject to a charge for value

Charge

C - Charge
COP - Charge of part
SBC - Sub charge

Discharge

DIS - Discharge
DP - Discharge of part

AmountDetails

ASTT - Assent
ASTC - Assent of charge
APT - Appointment of new trustee
ASSTTP - Assent (Transfer of part)
CPVK - Compulsory purchase (property value known)
CPVU - Compulsory purchase (property value unknown)
DFL1 - New lease - other
DFL3 - New lease - shared ownership
DFL4 - New lease - right to buy or right to acquire
DFL5 - Dispositionary first lease extension of a term
DL - Discontinuous lease - non-timeshare
DTL - Discontinuous lease - timeshare
LCSD - Lease closure - surrender by deed (not for value or reverse premium)
LCSDM - Lease closure - surrender by deed
LCSDWT - Lease closure - surrender by deed with a transfer (not for value or reverse premium)
LCSDMWT - Lease closure - surrender by deed (together with transfer)
LCSOL - Lease closure - surrender by operation of law (not for value or reverse premium)
LCSOLM - Lease closure - surrender by operation of law
RNT - Overriding lease granted under s.19, Landlord & Tenant (Covenants) Act 1995
TNVTP - Transfer (not for value or reverse premium) (Transfer of part)
TOC - Transfer of charge
TOSNVTP - Transfer of share (not for value or reverse premium) (Transfer of part)
TOSTP - Transfer of share for value (Transfer of part)
TOSV - Transfer of share for value
TPS - Transfer under power of sale
TPSTP - Transfer under power of sale (Transfer of part)
TRM - Transfer by operation of law on death
TSCNVTP - Transfer subject to a charge (not for value or reverse premium) (Transfer of part)
TSCTP - Transfer subject to a charge for value (Transfer of part)
TTP - Transfer for value (Transfer of part)
TVR - Transfer for value RTB/RTA
TVRTP - Transfer for value RTB/RTA (Transfer of part)
VO - Vesting order

Title types

Titles included as part of submission have a type field that informs HMLR how to process the application. This type depends on the application type, and the usage of the title within the application.

`REGISTER_UPDATE` and `REMOVE_JP1` application types

Only title types of REGISTER_TITLE are supported.

`TRANSFER_OF_PART` application types

The following title types are supported:

TRANSFEROR_TITLE - titles related to the transferor(s) on the application
ADDITIONAL_TITLE - any other titles on the application

`DISPOSITIONARY_FIRST_LEASE` application types

The following title types are supported:

LANDLORD_TITLES - titles related to the landlord(s) on the application
ADDITIONAL_TITLE - any other titles on the application

For a lease extension application (where the transaction type is DFL5 Dispositionary first lease extension of a term) a single title with type TENANT_TITLE must also be provided, which is related to the tenant on the application.

Change of name / Death of a joint proprietor (DJP)

HMLR will not accept applications where the registered proprietor information does not match the register (in the case of a change of name, or a death of a joint proprietor). The relevant transaction type must be applied for (ie. Change of name or DJP) with the corresponding evidence attached.

Party roles

Each party included in an application should be given a party role for each transaction it is used in. Parties can be given the following roles:

ATTORNEY 
TRANSFEROR 
TRANSFEREE
LENDER
BORROWER
PERSONAL_REPRESENTATIVE 
ASSENTOR 
LANDLORD 
TENANT

A party may be given different roles in different transactions. A party must not be used for multiple party roles within a single transaction, with the exception of the following transactions: ASTT, ASSTTP, ASTC, TOSNV, TOSNVTP, TOSTP, TOSV

Capacity fields

The capacity field is a data item within the party role object. The capacity field must be provided for Landlords, Tenants and Transferors when they are added as additional parties to transactions. It can be provided for any other party role, but this is optional.

The options for the capacity field are:

REGISTERED_PROPRIETOR 
ENTITLED_REGISTERED_PROPRIETOR 
ADDITIONAL_TRUSTEE 
INSOLVENCY_PRACTITIONER 
RECEIVER 
DEPUTY 
GUARDIAN 
PERSONAL_REPRESENTATIVE 
NOT_REQUIRED

Example request for capacity field:

“Select the capacity the Transferor is acting in. You’ll need to evidence the capacity to act and check whether ID evidence will be required.”

The capacity field is currently optional, but it may become mandatory in the future.

Field type: This field is a type String, with a set of enumerated values.

Acceptable values

The following values are acceptable:

Transaction/document mapping
Transaction type code	Document type code	Document class code
ADDITIONAL_TRUSTEE	Trustee	For example, for the purposes of over-reaching
DEPUTY		Appointed under the Mental Capacity Act 2005
ENTITLED_REGISTERED_PROPRIETOR		Person entitled to be registered as proprietor
GUARDIAN		Appointed under the Guardianship (Missing Persons) Act 2017
INSOLVENCY_PRACTITIONER	Trustee	In bankruptcy, liquidator, supervisor, administrator or administrative receiver appointed under the Insolvency Act 1986
PERSONAL_REPRESENTATIVE		Such as an executor, who assents or transfers the land or charge
RECEIVER		Appointed under the Law of Property Act 1925
REGISTERED_PROPRIETOR	The proprietor is registered	Default for those already on the Land Register. Applies to any manually entered details

Example:

The following JSON extract begins at the transactions node for an application’s submission. It is taken from the open API specification Exhaustive Example.

"transactions": {
  "discharge-transaction-reference": {
    "type": "DIS",
    "documents": [
      "document-reference"
    ],
    "party_roles": [
      {
        "party_reference": "private-individual-reference",
        "role": "ATTORNEY",
        "capacity": "REGISTERED_PROPRIETOR"
      }
    ],
    "details": {
      "type": "DISCHARGE",
      "discharge_submission_type": "ATTACHED"
    },
    "fee_in_pence": 0,
    "relates_to_new_title": false,
    "priority": 1,
    "title_references": [
      "title-ref"
    ]
  }
}

Attorneys

The attorney field is a data item within the party role object. It should be used to add a party reference for the attorney acting on behalf of that party.

Representation

All parties require a representation type. The representation type cannot be NOT_REQUIRED for Borrowers, Transferees and Transferors. The options are as follows:

LODGING_CONVEYANCER - the conveyancer lodging the application
OTHER_CONVEYANCER - the party is represented by another conveyancer. Details will be included with the application
NOT_REPRESENTED - the party is not represented by a conveyancer and identity evidence has been provided
NOT_REQUIRED - the party is not required to have a representation type. This should never be selected for Borrowers, Transferees or Transferors

List of validation rules

During application submission, several validation rules will run against the data provided to ensure it is valid. A number of these rules run synchronously before an application_request_id is returned and they are documented in the schema documentation. Other rules run asynchronously, after the application_request_id has been returned.

Bypass validation

If an application fails validation, users should rectify validation errors to avoid the need for bypassing, for example by adding the correct transactions (eg. DJP or Change of name for name discrepancies, and RX1 for restrictions within a transfer). Incorrect use of bypass rules will delay the processing of an application and could result in requisition points.

For exceptions to specific rules, we provide a bypass_validation array that applies to specific objects, as defined by the pointer.

Usage of validation bypass will be monitored. To use the bypass functionality, the following information is required:

validation_type - the type of validation rule you want to bypass. This is returned in the type field from any validation erro
validation_pointer - the location of the object in the payload structure. This is returned in the pointerfield from some validation errors
reason - the specific reason the bypass was required. Must be one of:

DISAGREE_WITH_REGISTER - the validation rule is incorrect because the data on the register is incorrect
HMLR_DATA_INCORRECT_OR_OUTDATED - there is missing, outdated or incorrect data in a comparison database
EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES - the application is valid. An exception should apply but is not covered by current business rules

comment - a user inputted description of why the validation is being bypassed

Bypassing validation can only be done for specific rules, and each rule is only permitted to have specific reasons for bypassing the validation. Information about which validation types support bypassing and which reasons are valid for those types are defined below:-color:

Validation bypass rules
Validation type	Valid bypass reasons
`all-proprietors-matched-to-borrowers`	`DISAGREE_WITH_REGISTER` `EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES`
`lender-name-matches-records`	`HMLR_DATA_INCORRECT_OR_OUTDATED`
`mdref-on-record`	`HMLR_DATA_INCORRECT_OR_OUTDATED`
`all-proprietors-matched-to-transferors`	`DISAGREE_WITH_REGISTER` `EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES`
`transferee-has-a-valid-address`	`HMLR_DATA_INCORRECT_OR_OUTDATED`
`all-mandatory-documents-provided`	`EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES`
`identity-evidence-has-type`	`EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES`
`required-identity-evidence-provided`	`EXCEPTION_NOT_COVERED_BY_BUSINESS_RULES`
`unique-lender`	`HMLR_DATA_INCORRECT_OR_OUTDATED`
`no-duplicate-lender-refs-on-charge`	`HMLR_DATA_INCORRECT_OR_OUTDATED`
`address-for-service-postcode-exists`	`HMLR_DATA_INCORRECT_OR_OUTDATED`

For an example; if after submitting an application the following error was received:

{
    "status": "VALIDATION_FAILED",
    "errors": [
        {
            "type": "all-proprietors-matched-to-borrowers",
            "detail": "There was a problem",
            "pointer": "/data/parties/borrower-1"
        }
    ]
}

The validation rule could then be overridden by submitting the same payload, but with the following addition:

{
  "data": {
    "bypass_validation": [{
      "validation_type": "all-proprietors-matched-to-borrowers",
      "validation_pointer": "/data/parties/borrower-1",
      "reason": "DISAGREE_WITH_REGISTER",
      "comment": "A comment about why the validation was incorrect"
    }],
    "addresses": {...},
    "parties": {...},
    // etc.
  }
}

This would resubmit the application, but this time ignoring the validation rule for the specific field identified by the pointer.

Additional provisions validation

The additional provisions code is specific to Tranfer transactions and is part of the Transfer object. For transfers, one of the following Additional Provision code options must be selected:

No provisions
Manual TR1 form
Details entered

For option three, details must be entered in the additional_provisions field.

Error types for this validator will be provided at a later date.

Address for service validation

Lenders and transferees must have an address for service option of “provided address”, with the exception of lenders which are only on a discharge transaction, or which appear on charge transactions with an MDRef.

If a party has an address for service option of “provided address”, at least one postal address must be provided. A maximum of three addresses can be provided per party.

The customer provided address will be validated.

An address for service validation error types
Error type	Description
`address-for-service-postcode-exists`	`Postcode provided does not exist in our records`
`address-for-service-option-is-valid`	`Each lender party must provide an address for service option` `Each lender party must have an address for service option of PROVIDED_ADDRESS, unless an MD Ref is provided` `Each transferee party must have an address for service option of PROVIDED_ADDRESS` `Each party must not have more than three addresses` `A party with an address for service option of PROVIDED_ADDRESS must contain at least one address of the following types: UK, OVERSEAS, PO_BOX, BFPO`

Applicant validation

Applicant must not have a party type of UNKNOWN.

Applicant validation error types
Error type	Description
`applicant-not-unknown-type`	`Applicant must not be of type UNKNOWN`

Borrower name validation

For charge transactions, all registered proprietors must match to a borrower in the transaction. This does not apply when a transfer transaction is included in the application.

If any registered proprietors are not matched, then the appropriate transaction (ie. Change of name or DJP) must be added to the application.

Borrower name validation error types
Error type	Description
`all-proprietors-matched-to-borrowers`	Can apply to one of the following: There must be at least as many borrowers as there are proprietors. There can be more, but no fewer A proprietor was not matched to a borrower and the corresponding evidence was not attached. Where there has been a change of name or the death of a joint proprietor and the register needs updating, the user must add the correct transaction and provide the appropriate evidence

Borrower representation validation

Representation type must be provided for the borrower role type. The respresentation type must not be NOT-REQUIRED.

Error types for this validator will be provided at a later date.

Borrower validation

For a charge or sub-charge transaction, at least one borrower must be present.

Borrower validation error types
Error type	Description
`transaction-has-valid-borrower`	Sub-charge transactions or charge transactions unaccompanied by a transfer transaction must have a borrower

Capacity validation

The capacity field must be provided for Landlords, Tenants and Transferors when they are added as additional parties to transactions.

Error types for this validator will be provided at a later date.

Charge amount validation

All charge transactions must have a charge value of 0 or greater.

Charge amount validation error types
Error type	Description
`charge-must-have-non-negative-value`	Charge value must be 0 or greater

Charge date validation

Charge date must be present and not a date in the future. Customer provided date must match the date in the charge deed.

Charge fee validation

The fee for charge transactions must be more than or equal to 2,000 pence, unless it is accompanied by a Scale Fee Transaction. If a charge is accompanied by a Scale Fee transaction then the charge fee must be 0.

Charge fee validation error types
Error type	Description
`CHARGE-FEE`	Fee for a charge transaction must be at least 2,000 pence Fee must be 0 pence for a charge transaction accompanied by a Scale Fee transaction

Company number validation

For any party of type UKCompany, the data item company_number is required, except when any of the following are true:

The party is being used as a lender on a transaction with a valid MDRef
The party is being used as a borrower

In these cases the company_number is optional.

Company number validation error types
Error type	Description
`uk-company-has-company-number`	A party with type UKCompany didn’t include a company number and it wasn’t a borrower or a lender with a valid MDRef for the transaction on which it is being used as a lender

Consideration type validation

For Transfer transactions, a consideration type of either Monetary Value, No Monetary Value, or Other must be present.

When consideration type is MONETARY_VALUE, a transfer value must be present. When consideration type is OTHER, a consideration description must be provided.

The consideration type must be MONETARY_VALUE for the following transactions: T, TOSV, TSCV.

The consideration type must be either NO_MONETARY_VALUE or OTHER for the following transactions: TNV, TOSNV, TSCNV

Consideration type validation error types
Error type	Description
`consideration-type-is-valid`	Transactions type was paired with an invalid consideration type A transfer value must be provided when consideration type is `MONETARY_VALUE`

Conveyancers certificate validation

Checks the conveyancers_certificate field is set for any document of type CERT_REG_CH.

Conveyancer certificate validation error types
Error type	Description
`conveyancers-certificate-provided`	Conveyancers certificate was not provided for Certificate of registration issued by Companies House documents

Customer ID validation

The provided customer ID must exist in the HMLR system.

Customer ID validation error types
Error type	Description
`customer-id-exists`	The provided customer ID was not found in HMLR internal systems

Customer type validation

Customer type of conveyancer or non-conveyancer must be present.

Declaration of trust validation

A declaration of trust must be provided for transfers with two or more transferees.

The "trust declaration type" field must include one of the following options:

Joint Tenants
Tenants in Common
Trust Details
Form JO

For option three, the "trust details" field must be provided. For option four, HMLR form JO must be provided as an attachment.

Declaration of trust validation error types
Error type	Description
`declaration-of-trust`	The trust declaration type must be provided The details of trust must be provided where the “trust details” option was selected The JO form must be provided where “Form JO was provided”

DFL5 validation

For DFL5 applications (Dispositionary first lease extension of a term) there must be at least one title with type LANDLORD_TITLE and a single title with type TENANT_TITLE, which is related to the tenant on the application.

DFL5 validation error types
Error type	Description
`lease-extension-is-valid`	DFL5 transactions must contain exactly one tenant title DFL5 transactions must contain at least one landlord titled

Discharge fee validation

The fee provided for discharge transactions must be 0.

Discharge fee validator error types
Error type	Description
`discharge-fee-zero`	Discharge transaction must have a fee of 0

Disclosable overriding interests validation

When disclosable_overriding_interests is set to true on any title, a FORM_DI document must be provided with the application.

Disclosable overriding interests validation error types
Error type	Description
`di-form-required`	A Disclosable Overriding Interests (DI) Form is required but has not been provided

Document type validation

The documents mentioned in the order/submission request must have the same DocumentType as those uploaded.

Document type validation error types
Error type	Description
`document-type-valid`	The document type submitted was not the same as the document type uploaded

h3 class=“govuk-heading-s”>Document validation

The file size of documents must be below 40mb (but must not have a zero size). Files must be either PDF, GIF, TIFF or JPG format. The file must not be encrypted or password protected. If a TIFF file, it must be a valid TIFF file.

Document validation error types
Error type	Description
`document-valid`	This could be because the document is too large, of zero size, the wrong format, an invalid TIFF file, encrypted or password protected

Evidence of consent to restriction warning

This warning is displayed when there is a restriction on a title and evidence of consent to that restriction has not been provided. If it is not provided but it is required, there will be delays to the application.

Evidence of discharge warning

This warning is displayed when evidence of discharge may be required, for example when the application is a transfer and a charge exists on the register, or if certain entries are present on the register. If evidence of discharge is not provided and early completion cannot be applied, there will be delays to the application.

Identity evidence validation

Identity evidence type must be provided for each party with a representation type of NOT_REPRESENTED - view Practice Guide 67 (opens in new tab).

There must be at least as many evidence documents as the number of parties that have indicated they are providing evidence.

Identity evidence validation error types
Error type	Description
`identity-evidence-has-type`	One of the following options must be provided for unrepresented parties: Evidence Verified Not required
`required-identity-evidence-provided`	At least one HMLR identity form must be provided for each unrepresented party

JP1 validation

If the application type is “Remove JP1” then there must be exactly one transaction within that application. This must be a JP1 transaction. There must be exactly one title number in this application. A JP1 reference must be provided and this must match a JP1 reference within our records that is attached to the title in the application.

If the application type is not “Remove JP1”, there must not be a JP1 transaction present. A JP1 reference must not be provided.

Error type for this validator will be provided at a later date.

Lease transactions party role validation

For the following lease transactions, there must be at least one tenant and one landlord party:

DFL1
DFL3
DFL4
DFL5
DL
DTL

Lease transactions party role validation error types
Error type	Description
`lease-extension-has-landlord-and-tenant`	The lease transaction is missing a landlord and/or tenant party

Lender name validation

When an MD reference is provided, a charge can only have one lender party. A charge without an MD reference may have more than one lender party. These lenders must be unique parties.

Warning: When an MD reference is provided, the lender name associated with the charge must match the lender name associated with the MD reference in HMLR systems.

Lender name validation error types
Error type	Description
`unique-lender`	Each charge should only have one lender
`lender-name-matches-records`	Warning: The lender name provided in the application data must match that recorded for the lender in our MD reference database
`no-duplicate-lender-refs-on-charge`	Lender references must be unique

Lender validation

All charges require at least one party with the role type of lender. The lender address is not required if a valid MD reference is provided. If the charge does not have an MD reference, a full postal address for the lender is required.

Lender validation error types
Error type	Description
`charge-has-valid-lender`	This could be due to: no lenders on the charge application the lender having an invalid address for service when an MD reference was not provided. At least one valid full postal address must be provided

Mandatory documents validation

Validation will be applied for each transaction to ensure the rules regarding the Compulsory and Either document types have been satisfied correctly.

Mandatory documents validation error types
Error type	Description
`all-mandatory-documents-provided`	Each transaction must have the mandatory deed(s) or document(s) provided

MD reference validation

The MD reference included in the application must be in the right format, exist as a live MD reference and match the MD reference contained in the charge.

MD reference validation error types
Error type	Description
`mdref-on-record`	The MD reference supplied cannot be found in our database

Property address validation

The HMLR property description associated with customer supplied title number will be compared against the property description contained in the charge and/or transfer deeds.

Error types for this validator will be provided at a later date.

Proprietor address for service validation

Proprietor address for service must be a valid postal address. The customer provided address will be validated.

Proprietor address for service validation error types
Error type	Description
`address-for-service-option-is-valid`	The address for service option provided for the party is invalid

Representation type validation

One of the following options must be selected:

Lodging conveyancer
Other conveyancer

The party roles of borrower, transferor and transferee cannot have the representation type of NOT_REQUIRED.

If the application lodger is not a conveyancer, then no parties can use the LODGING_CONVEYANCER representation type.

Representation validation error types
Error type	Description
`party-representation-type-is-valid`	For an application lodged by a non-conveyancer, no representation type may be `LODGING_CONVEYANCER`

Submission warning validation

A legal declaration is made when submitting an application with regards dishonesty etc. The conveyancer must agree to comply with the warning.

Submission warning validation error types
Error type	Description
`submission-warning-understood`	A legal declaration is made when submitting an application with regards dishonesty etc. The conveyancer must agree to comply with the warning

Title number validation

The title number in the application must match a title number in the land register. The title number must be valid - view the TITLE_NOT_VALID error type below for information on valid titles. For multi-title applications please provide each title once.

Title number validation error types
Error type	Description
`unknown-title-number`	Title number not matched to HMLR systems
`title-must-be-valid`	Can apply to one of the following: For an application type of ‘Transfer of Part’, ‘Removal of default form A restriction’ or ‘Dispositionary first lease’, the title number must have a single valid district code An application type of ‘Transfer of Part’ or ‘Dispositionary first lease’ cannot be lodged against a title with an estate interest of ‘Affecting Franchise’ or ‘Relating Franchise’ An application cannot be lodged against a caution title The title number must not be recorded as a closed title The title number must exist and not be recorded as a closed title, a scheme title, or a new title allocated to a new title dealing on Land Registry systems

Title scope validation

Title scopes of “whole” must not have a part description. Title scopes of “part” must have a part description.

Title scope validation error types
Error type	Description
`title-scope-is-valid`	Title scopes of ‘part’ must have a part description Title scopes of ‘whole’ must not have a part description

Title type validation

If the title type provided for a title number is LANDLORD_TITLE, the title tenure on our records for title number must be “freehold”.

If the title type provided for a title number is TENANT_TITLE, the title tenure on our records for the title number must be “leasehold”.

If the title type provided for a title number is REGISTER_TITLE, TRANSFEROR_TITLE, or ADDITIONAL_TITLE, the title tenure on our records for the title number can be either “freehold” or “leasehold”.

Title type validation error types
Error type	Description
`title-type-matches-tenure`	The title type provided does not have the appropriate tenure in our records

Transfer amount validation

Value must be provided, either as an exact value or a value band (where transfer is not for monetary value).

Transfer date validation

The transfer date must match what is on the transfer deed to be correct. It must not be in the future.

Transfer number validation

An application must have a maximum of one transfer transaction.

Transfer number validation error types
Error type	Description
`order-contains-one-transfer`	Order must contain at most one transfer transaction

Transferee validation

All Transfer transactions must have at least one transferee present. Each transferee must have a representation type that is not NOT_REQUIRED.

At least one valid postal address must be provided as the address for service. If overseas, the address must have a country.

Transferee validation error types
Error type	Description
`transfer-has-transferee`	A transfer involves a change of proprietor(s). If making an application for a transfer, there must be at least one transferee
`transferee-has-valid-address`	At least one postal address must be provided in the application

Transferor name validation

For transfer transactions, all registered proprietors must match to a transferor in the transaction. If a registered proprietor does not match a transferor then the appropriate transaction (i./e Change of Name or Death of Joint Proprietor) must be added to the application.

Transferor name error types
Error type	Description
`all-proprietors-matched-to-transferors`	There must be at least as many transferors as there are proprietors. There can be more, but no fewer A proprietor was not matched to a transferor and the corresponding evidence was not attached. Where there has been a change of name or the death of a joint proprietor and the register needs updating evidence must be provided

Transferor validation

There must be at least one transferor name on each transfer transaction, with the exception of TRM transactions.

Each transferor must have a representation type that is not NOT_REQUIRED.

Transferor validation error types
Error type	Description
`transfer-has-transferors`	A transfer involves a change of proprietor(s). If making an application for a transfer, there must be at least one transferor

Value bands

Value bands specify the approximate value of a property, or the equity being transferred, where the exact value is not known. The value band fields can be found on the Transfer and AmountDetails objects in the API specification.

The valid value bands are as follows (in pounds):

lower_band: 0, upper_band: 100,000
lower_band: 100,001, upper_band: 200,000
lower_band: 200,001, upper_band: 500,000
lower_band: 500,001, upper_band: 1,000,000
lower_band: 1,000,001, upper_band: null

Value bands are only applicable to the following transaction types:

APT - Appointment of new trustee
ASTT - Assent
ASSTTP - Assent (Transfer of part)
TNV - Transfer (not for value or reverse premium)
TNVTP - Transfer (not for value or reverse premium) (Transfer of part)
TOSNV - Transfer of share (not for value or reverse premium)
TOSNVTP - Transfer of share (not for value or reverse premium) (Transfer of part)
TRM - Transfer by operation of law on death
TSCNV - Transfer subject to a charge (not for value or reverse premium)
TSCNVTP - Transfer subject to a charge (not for value or reverse premium) (Transfer of part)
VO - Vesting order

There are several rules regarding value band usage:

Both value (i.e. value of equity being transferred) and full_value_of_property must be either value bands, or exact values
The full_value_of_property_band must be greater than or equal to the value_band (i.e. the value of equity being transferred)

Value band error types
Error type	Description
`full-value-of-property-or-band-is-valid`	Full value of property must be greater than or equal to property value Full value of property band must be greater than or equal to property value band Value bands were used for a transaction type that does not allow value band usage

Example:

"transactions": {
  "transaction-1": {
    "type": "TNV",
    "details": {
      "type": "transfer",
      "value_band": {
        "lower_value_band": 100001,
        "upper_value_band": 200000
      },
      "outstanding_charge": 0,
      "full_value_of_property_band": {
        "lower_value_band": 200001,
        "upper_value_band": 500000
      }
    },
    "title_numbers": [...]
  }
}

Example requests and responses

`APPLICATION_ACCEPTED_ON_DAY_LIST` notification

{
  "data": [
    {
      "notification_id": "7788bfb3-02f2-4c9b-be58-94e9df010ac8",
      "created_datetime": "2025-02-25T16:17:19.120585661Z",
      "payload_schema": "https://landregistry.github.io/bgtechdoc/vcad/schemas/accepted-priority-protected.json",
      "notification_type": "APPLICATION_ACCEPTED_ON_DAY_LIST",
      "subject_type": "LAND_REGISTER_APPLICATION",
      "subject": "3d4b51cf-76ab-40ad-9b09-099323034adf",
      "event_datetime": "2025-02-20T09:06:29.120585661Z",
      "status": "NEW",
      "payload": {
        "data": {
          "status": "ACCEPTED_PRIORITY_PROTECTED",
          "priority": "2025-02-20T09:06:29.04",
          "hmlr_reference": "A123ABR"
        }
      }
    }
  ]
}

`APPLICATION_VALIDATION_FAILED` notification

{
  "data": [
    {
      "notification_id": "7788bfb3-02f2-4c9b-be58-94e9df010ac8",
      "created_datetime": "2025-02-25T16:17:19.120585661Z",
      "payload_schema": "https://landregistry.github.io/bgtechdoc/vcad/schemas/accepted-priority-protected.json",
      "notification_type": "APPLICATION_VALIDATION_FAILED",
      "subject_type": "LAND_REGISTER_APPLICATION",
      "subject": "3d4b51cf-76ab-40ad-9b09-099323034adf",
      "event_datetime": "2025-02-20T09:06:29.120585661Z",
      "status": "NEW",
      "payload": {
        "data": {
          "status": "VALIDATION_FAILED"
        }
      }
    }
  ]
}

`POST - /v0/applications` - Charge

{
    "data": {
        "type": "REGISTER_UPDATE",
        "submission_warning_understood": true,
        "customer_reference": "MyApplication",
        "application_lodger": {
            "email": user@company.com,
            "telephone": "07000000000",
            "type": "CONVEYANCER"
        },
        "addresses": {
            "borrower-address-1": {
                "details": {
                    "type": "UK",
                    "number": "1",
                    "postcode": "AA1 00Z"
                }
            }
        },
        "applicants": [
            "borrower-1"
        ],
        "documents": {
            "mortgage-deed": {
                "document_id": "0001",
                "document_metadata": {
                    "certification_statement_type": "CERTIFIED",
                    "document_filename": "deed.pdf"
                },
                "type": "MRTG_DEED"
            }
        },
        "parties": {
            "borrower-1": {
                "address_for_service_option": "PROVIDED_ADDRESS",
                "addresses": [
                    "borrower-address-1"
                ],
                "details": {
                    "type": "PRIVATE_INDIVIDUAL",
                    "forenames": "Alice",
                    "surname": "Smith"
                },
                "identity_evidence_type": "NOT_REQUIRED",
                "representation_type": "LODGING_CONVEYANCER"
            },
            "lender-1": {
                "address_for_service_option": "NOT_REQUIRED",
                "identity_evidence_type": "NOT_REQUIRED",
                "details": {
                    "type": "UK_COMPANY",
                    "company_number": "543252345",
                    "organisation_name": "A. Bank"
                },
                "representation_type": "NOT_REPRESENTED"
            }
        },
        "titles": {
            "tn1": {
                "title_number": "TN001",
                "title_type": "REGISTER_TITLE",
                "disclosable_overriding_interests": false,
                "scope_details": {
                    "scope": "WHOLE"
                }
            }
        },
        "transactions": {
            "C1": {
                "type": "C",
                "fee_in_pence": 100,
                "priority": 1,
                "details": {
                    "type": "CHARGE",
                    "date": "2024-01-01",
                    "mdref": "MD00AA",
                    "value": 345000
                },
                "documents": [
                    "mortgage-deed"
                ],
                "party_roles": [
                    {
                        "capacity": "REGISTERED_PROPRIETOR",
                        "party_reference": "borrower-1",
                        "role": "BORROWER"
                    },
                    {
                        "capacity": "NOT_REQUIRED ",
                        "party_reference": "lender-1",
                        "role": "LENDER"
                    }
                ],
                "title_references": [
                    "tn1"
                ]
            }
        }
    }
}

`POST - /v0/applications` - Transfer

{
  "data": {
    "submission_warning_understood": true,
    "customer_reference": "MyApplication",
    "type": "REGISTER_UPDATE",
    "application_lodger": {
      "email": user@company.com,
      "telephone": "07000000000",
      "type": "CONVEYANCER"
    },
    "applicants": [
      "transferor-1",
      "transferor-2"
    ],
    "addresses": {
      "transferor-address-1": {
        "details": {
          "type": "UK",
          "building_description": "1",
          "post_town": "Fake Town",
          "postcode": "AA1 00Z"
        }
      },
      "transferee-address-1": {
        "details": {
          "type": "UK",
          "building_description": "2",
          "post_town": "Fake Town",
          "postcode": "AA1 00Z"
        }
      }
    },
    "parties": {
      "transferor-1": {
        "reference": "transferor-1",
        "addresses": [
          "transferor-address-1"
        ],
        "details": {
          "type": "PRIVATE_INDIVIDUAL",
          "forenames": "Jane",
          "surname": "Doe"
        },
        "representation_type": "LODGING_CONVEYANCER",
        "address_for_service_option": "PROVIDED_ADDRESS"
      },
      "transferor-2": {
        "reference": "transferor-2",
        "details": {
          "type": "PRIVATE_INDIVIDUAL",
          "forenames": "John",
          "surname": "Doe"
        },
        "addresses": [
          "transferor-address-1"
        ],
        "representation_type": "LODGING_CONVEYANCER",
        "address_for_service_option": "PROVIDED_ADDRESS"
      },
      "transferee-1": {
        "reference": "transferee-1",
        "details": {
          "type": "OVERSEAS_COMPANY",
          "organisation_name": "OverseaComp Inc.",
          "incorporation_territory": "Europe under the Treaty on European Union and the Treaty on the Functioning of the European Union",
          "company_number": "123456"
        },
        "addresses": [
          "transferee-address-1"
        ],
        "representation_type": "NOT_REPRESENTED",
        "identity_evidence_type": "VERIFIED",
        "address_for_service_option": "PROVIDED_ADDRESS"
      },
      "lender-1": {
        "reference": "lender-1",
        "address_for_service_option": "NOT_REQUIRED",
        "identity_evidence_type": "NOT_REQUIRED",
        "representation_type": "NOT_REPRESENTED",
        "details": {
          "type": "UK_COMPANY",
          "company_number": "543252345",
          "organisation_name": "A. Bank"
        }
      }
    },
    "titles": {
      "tn1": {
        "title_number": "TN001",
        "title_type": "REGISTER_TITLE",
        "disclosable_overriding_interests": false,
        "scope_details": {
          "scope": "WHOLE"
        }
      },
      "tn2": {
        "title_number": "TN002",
        "title_type": "REGISTER_TITLE",
        "disclosable_overriding_interests": false,
        "scope_details": {
          "scope": "PART",
          "part_description": "The field on the north side of the property"
        }
      }
    },
    "transactions": {
      "dis": {
        "type": "DIS",
        "fee_in_pence": 0,
        "priority": 1,
        "details": {
          "type": "DISCHARGE",
          "discharge_submission_type": "ATTACHED"
        },
        "party_roles": [
          {
            "party_reference": "transferor-1",
            "role": "BORROWER",
            "capacity": "REGISTERED_PROPRIETOR"
          },
          {
            "party_reference": "transferor-2",
            "role": "BORROWER",
            "capacity": "REGISTERED_PROPRIETOR"
          }
        ],
        "title_references": [
          "tn1"
        ],
        "documents": [
          "discharge"
        ]
      },
      "transfer": {
        "type": "T",
        "fee_in_pence": 135,
        "priority": 2,
        "details": {
          "type": "TRANSFER",
          "additional_provisions_code": "MANUAL_TR1_FORM",
          "date": "2024-01-01",
          "value": 500000,
          "consideration_type": "MONETARY_VALUE",
          "consideration_description": "Value of 500000 including VAT",
          "title_guarantee_code": "FULL",
          "trust_declaration_type": "JOINT_TENANTS"
        },
        "party_roles": [
          {
            "party_reference": "transferor-1",
            "role": "TRANSFEROR",
            "capacity": "REGISTERED_PROPRIETOR"
          },
          {
            "party_reference": "transferor-2",
            "role": "TRANSFEROR",
            "capacity": "REGISTERED_PROPRIETOR"
          },
          {
            "party_reference": "transferee-1",
            "role": "TRANSFEREE",
            "capacity": "ENTITLED_REGISTERED_PROPRIETOR"
          }
        ],
        "title_references": [
          "tn1",
          "tn2"
        ],
        "documents": [
          "tr1",
          "identity-evidence"
        ]
      },
      "charge": {
        "type": "C",
        "fee_in_pence": 0,
        "priority": 3,
        "details": {
          "type": "CHARGE",
          "date": "2024-01-01",
          "mdref": "MD00AA",
          "value": 200000
        },
        "documents": [
          "mortgage-deed"
        ],
        "party_roles": [
          {
            "capacity": "REGISTERED_PROPRIETOR",
            "party_reference": "transferee-1",
            "role": "BORROWER"
          },
          {
            "capacity": "NOT_REQUIRED",
            "party_reference": "lender-1",
            "role": "LENDER"
          }
        ],
        "title_references": [
          "tn1",
          "tn2"
        ]
      }
    },
    "documents": {
      "tr1": {
        "type": "TR1",
        "document_id": "00001",
        "document_metadata": {
          "certification_statement_type": "CERTIFIED",
          "document_filename": "tr1.pdf"
        }
      },
      "identity-evidence": {
        "type": "EVIDENCE",
        "document_id": "00002",
        "document_metadata": {
          "certification_statement_type": "CERTIFIED_BY_ANOTHER",
          "document_filename": "evidence.pdf"
        }
      },
      "discharge": {
        "type": "DISCHARGE",
        "document_id": "00003",
        "document_metadata": {
          "certification_statement_type": "CERTIFIED",
          "document_filename": "discharge.pdf"
        }
      },
      "mortgage-deed": {
        "type": "MRTG_DEED",
        "document_id": "00004",
        "document_metadata": {
          "certification_statement_type": "CERTIFIED_BY_ANOTHER",
          "document_filename": "deed.pdf"
        }
      }
    }
  }
}

`POST - /v0/applications` - Transfer of Part

{
  "data": {
    "type": "TRANSFER_OF_PART",
    "customer_reference": "tp-not-for-value",
    "submission_warning_understood": true,
    "application_lodger": {
      "email": user@company.com,
      "telephone": "07000000000",
      "type": "NON_CONVEYANCER"
    },
    "addresses": {
      "transferor-address-1": {
        "details": {
          "type": "UK",
          "building_description": "1",
          "post_town": "Fake Town",
          "postcode": "AA1 00Z"
        }
      },
      "transferee-address-1": {
        "details": {
          "type": "UK",
          "building_description": "2",
          "post_town": "Fake Town",
          "postcode": "AA1 00Z"
        }
      }
    },
    "applicants": [
      "transferor-1"
    ],
    "parties": {
      "transferor-1": {
        "addresses": [
          "transferor-address-1"
        ],
        "details": {
          "type": "PRIVATE_INDIVIDUAL",
          "forenames": "Jane",
          "surname": "Doe"
        },
        "representation_type": "LODGING_CONVEYANCER",
        "address_for_service_option": "PROVIDED_ADDRESS"
      },
      "transferee-1": {
        "addresses": [
          "transferee-address-1"
        ],
        "details": {
          "type": "PRIVATE_INDIVIDUAL",
          "forenames": "John",
          "surname": "Doe"
        },
        "representation_type": "OTHER_CONVEYANCER",
        "other_conveyancer": {
          "conveyancer_reference": "ABC123",
          "full_name": "Mike Ross",
          "registered_address": "1234 56th Street, New York, 10001"
        },
        "address_for_service_option": "PROVIDED_ADDRESS"
      }
    },
    "titles": {
      "tn1": {
        "title_number": "TN001",
        "title_type": "TRANSFEROR_TITLE",
        "disclosable_overriding_interests": false,
        "scope_details": {
          "scope": "PART",
          "part_description": "The field on the north side of the property"
        }
      }
    },
    "transactions": {
      "tnv": {
        "type": "TNVTP",
        "fee_in_pence": 45,
        "priority": 1,
        "details": {
          "type": "TRANSFER",
          "value_band": {
            "lower_value_band": 100001,
            "upper_value_band": 200000
          },
          "outstanding_charge": 0,
          "full_value_of_property_band": {
            "lower_value_band": 1000001
          },
          "date": "2024-01-01",
          "title_guarantee_code": "LIMITED",
          "consideration_type": "NO_MONETARY_VALUE",
          "additional_provisions_code": "NO_PROVISIONS"
        },
        "documents": [
          "tp-1"
        ],
        "party_roles": [
          {
            "party_reference": "transferor-1",
            "role": "TRANSFEROR",
            "capacity": "REGISTERED_PROPRIETOR"
          },
          {
            "party_reference": "transferee-1",
            "role": "TRANSFEREE",
            "capacity": "ENTITLED_REGISTERED_PROPRIETOR"
          }
        ],
        "title_references": [
          "tn1"
        ]
      }
    },
    "documents": {
      "tp-1": {
        "reference": "tp-1",
        "type": "TP1",
        "document_id": "00001",
        "document_metadata": {
          "certification_statement_type": "CERTIFIED_BY_ANOTHER",
          "document_filename": "tp1.gif"
        }
      }
    }
  }
}

Version and Status

How to use the Submit an application API

Notifications

Schemas

Validation rules

SOAP migration guide

List of valid territories

Transaction and document types

Valid transaction types per application type

REGISTER_UPDATE

TRANSFER_OF_PART

DISPOSITIONARY_FIRST_LEASE

REMOVE_JP1

Additional transaction details

Title types

REGISTER_UPDATE and REMOVE_JP1 application types

TRANSFER_OF_PART application types

DISPOSITIONARY_FIRST_LEASE application types

Change of name / Death of a joint proprietor (DJP)

Party roles

Capacity fields

Attorneys

Representation

List of validation rules

Bypass validation

Additional provisions validation

Address for service validation

Applicant validation

Borrower name validation

Borrower representation validation

Borrower validation

Capacity validation

Charge amount validation

Charge date validation

Charge fee validation

Company number validation

Consideration type validation

Conveyancers certificate validation

Customer ID validation

Customer type validation

Declaration of trust validation

DFL5 validation

Discharge fee validation

Disclosable overriding interests validation

Document type validation

Evidence of consent to restriction warning

Evidence of discharge warning

Identity evidence validation

JP1 validation

Lease transactions party role validation

Lender name validation

Lender validation

Mandatory documents validation

MD reference validation

Property address validation

Proprietor address for service validation

Representation type validation

Submission warning validation

Title number validation

Title scope validation

Title type validation

Transfer amount validation

Transfer date validation

Transfer number validation

Transferee validation

Transferor name validation

Transferor validation

Value bands

Example requests and responses

APPLICATION_ACCEPTED_ON_DAY_LIST notification

APPLICATION_VALIDATION_FAILED notification

POST - /v0/applications - Charge

POST - /v0/applications - Transfer

POST - /v0/applications - Transfer of Part

Related APIs

`REGISTER_UPDATE`

`TRANSFER_OF_PART`

`DISPOSITIONARY_FIRST_LEASE`

`REMOVE_JP1`

`REGISTER_UPDATE` and `REMOVE_JP1` application types

`TRANSFER_OF_PART` application types

`DISPOSITIONARY_FIRST_LEASE` application types

`APPLICATION_ACCEPTED_ON_DAY_LIST` notification

`APPLICATION_VALIDATION_FAILED` notification

`POST - /v0/applications` - Charge

`POST - /v0/applications` - Transfer

`POST - /v0/applications` - Transfer of Part