HM Land Registry · Example Payload
Hm Land Registry Submit An Application 1.0 Test Stubs
Real EstateUnited KingdomLand RegistryOpen DataTitleConveyancingProperty RecordsPrice Paid DataLinked DataGeospatialGovernmentPropTech
Hm Land Registry Submit An Application 1.0 Test Stubs is an example object payload from HM Land Registry, with 5 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
_source_harvested_method_noteexamples
Example Payload
{
"_source": "https://landregistry.github.io/bg-dev-pack-redesign/apis/submit-an-application/1.0/test-stubs",
"_harvested": "2026-07-26",
"_method": "searched",
"_note": "Request and response bodies published verbatim by HM Land Registry as test stubs. Nothing here was invented or modified.",
"examples": [
{
"data": {
"submission_warning_understood": true,
"applicants": [
"Borrower1",
"Borrower2"
],
"customer_reference": "CustomerRef",
"documents": {
"Deed": {
"type": "MRTG_DEED",
"document_id": "a40d6fe0-bd45-4c49-b72a-0d80cf43db83",
"document_metadata": {
"certification_statement_type": "CERTIFIED",
"document_filename": "Deed.pdf"
}
}
},
"parties": {
"Borrower1": {
"representation_type": "LODGING_CONVEYANCER",
"address_for_service_option": "NOT_REQUIRED",
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Tony",
"surname": "Bonito"
}
},
"Borrower2": {
"representation_type": "LODGING_CONVEYANCER",
"address_for_service_option": "NOT_REQUIRED",
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Toni",
"surname": "Bonito"
}
},
"TheBank": {
"representation_type": "LODGING_CONVEYANCER",
"address_for_service_option": "NOT_REQUIRED",
"details": {
"type": "UK_COMPANY",
"company_number": "12345",
"organisation_name": "Albion Home Loans Limited"
}
}
},
"application_lodger": {
"email": "valid.email@landregistry.gov.uk",
"address_for_service_option": "NOT_REQUIRED",
"type": "CONVEYANCER"
},
"titles": {
"MS305610": {
"disclosable_overriding_interests": "false",
"title_number": "MS305610",
"title_type": "REGISTER_TITLE",
"scope_details": {
"scope": "WHOLE"
}
}
},
"transactions": {
"Charge": {
"priority": 1,
"title_references": [
"MS305610"
],
"documents": [
"Deed"
],
"type": "C",
"fee_in_pence": 3000,
"details": {
"type": "CHARGE",
"date": "2024-01-01",
"mdref": "MD006A",
"value": 0
},
"party_roles": [
{
"party_reference": "Borrower1",
"role": "BORROWER"
},
{
"party_reference": "Borrower2",
"role": "BORROWER"
},
{
"party_reference": "TheBank",
"role": "LENDER"
}
]
}
},
"type": "REGISTER_UPDATE"
}
},
{
"data": {
"application_request_id": "b3ac19be-2b6d-4b8a-971c-e758b0e8e790"
}
},
{
"data": {
"submission_warning_understood": true,
"customer_reference": "CustomerRef",
"addresses": {
"transferee_address": {
"details": {
"type": "UK",
"uprn": 100040203976,
"building_description": "Apartment 11",
"street": "113 Newton Street",
"post_town": "MANCHESTER",
"postcode": "M1 1AE",
"full_address": "Apartment 11 ,113 Newton Street, MANCHESTER, M1 1AE",
"care_of_name": "SP"
}
}
},
"documents": {
"TR1": {
"document_id": "a40d6fe0-bd45-4c49-b72a-0d80cf43db83",
"type": "TR1",
"document_metadata": {
"certification_statement_type": "CERTIFIED",
"document_filename": "TR1.pdf"
}
}
},
"parties": {
"Transferee": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "John",
"surname": "Smith"
},
"representation_type": "LODGING_CONVEYANCER",
"address_for_service_option": "PROVIDED_ADDRESS",
"addresses": "transferee_address"
},
"Transferor1": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Tony",
"surname": "Bonito"
},
"other_conveyancer": {
"full_name": "ABC Conveyancers",
"registered_address": "13 Coral Close, Tuffley, Gloucester, GL4 0RG",
"conveyancer_reference": "abc-conveyancers-ref"
},
"representation_type": "OTHER_CONVEYANCER",
"address_for_service_option": "NOT_REQUIRED"
},
"Transferor2": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Toni",
"surname": "Bonito"
},
"other_conveyancer": {
"full_name": "ABC Conveyancers",
"registered_address": "13 Coral Close, Tuffley, Gloucester, GL4 0RG",
"conveyancer_reference": "abc-conveyancers-ref"
},
"representation_type": "OTHER_CONVEYANCER",
"address_for_service_option": "NOT_REQUIRED"
}
},
"applicants": [
"Transferee"
],
"application_lodger": {
"email": "valid.email@landregistry.gov.uk",
"type": "CONVEYANCER"
},
"titles": {
"MS312531": {
"disclosable_overriding_interests": "false",
"title_number": "MS312531",
"title_type": "REGISTER_TITLE",
"scope_details": {
"scope": "WHOLE"
}
}
},
"transactions": {
"Transfer": {
"priority": 1,
"title_references": [
"MS312531"
],
"documents": [
"TR1"
],
"type": "T",
"fee_in_pence": 3000,
"details": {
"type": "TRANSFER",
"title_guarantee_code": "FULL",
"additional_provisions_code": "NO_PROVISIONS",
"consideration_description": "string",
"consideration_type": "MONETARY_VALUE",
"value": 1300000,
"full_value_of_property": 1300000,
"date": "2023-12-12",
"trust_declaration_type": "TRUST_DETAILS"
},
"party_roles": [
{
"party_reference": "Transferee",
"role": "TRANSFEREE"
},
{
"party_reference": "Transferor1",
"role": "TRANSFEROR"
},
{
"party_reference": "Transferor2",
"role": "TRANSFEROR"
}
]
}
},
"type": "REGISTER_UPDATE"
}
},
{
"data": {
"application_request_id": "2563940e-ae95-4e7e-9b33-49a6571abdf6"
}
},
{
"data": {
"submission_warning_understood": true,
"applicants": [
"Borrower1",
"Borrower2"
],
"customer_reference": "CustomerRef",
"documents": {
"Deed": {
"type": "MRTG_DEED",
"document_id": "0d7bd3a5-1aec-4862-9fc9-f796dfc11d35",
"document_metadata": {
"certification_statement_type": "CERTIFIED",
"document_filename": "Deed.pdf"
}
}
},
"parties": {
"Borrower1": {
"representation_type": "LODGING_CONVEYANCER",
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Tony",
"surname": "Bonito"
}
},
"Borrower2": {
"representation_type": "LODGING_CONVEYANCER",
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Toni",
"surname": "Bonito"
}
},
"TheBank": {
"representation_type": "LODGING_CONVEYANCER",
"details": {
"type": "UK_COMPANY",
"company_number": "12345",
"organisation_name": "Albion Home Loans Limited"
}
}
},
"application_lodger": {
"email": "valid.email@landregistry.gov.uk",
"type": "CONVEYANCER"
},
"titles": {
"MS305610": {
"disclosable_overriding_interests": "false",
"title_number": "MS305610",
"scope_details": {
"scope": "WHOLE",
"part_description": null
},
"title_type": "REGISTER_TITLE"
}
},
"transactions": {
"Charge": {
"documents": [
"Deed"
],
"type": "C",
"priority": 1,
"fee_in_pence": 3000,
"details": {
"type": "CHARGE",
"date": "3000-01-01",
"mdref": "MD006A"
},
"party_roles": [
{
"party_reference": "Borrower1",
"role": "BORROWER"
},
{
"party_reference": "Borrower2",
"role": "BORROWER"
},
{
"party_reference": "TheBank",
"role": "LENDER"
}
]
}
},
"type": null
}
},
{
"type": "https://landregistry.github.io/bgtechdoc/problems/global#bad-request",
"title": "Bad Request",
"detail": "The request is invalid or malformed.",
"status": "400",
"errors": [
{
"type": "OCV_L1A_000",
"pointer": "/data/transactions/Charge/details/date",
"detail": "Date must be in the past or in the present"
},
{
"type": "OCV_L1A_000",
"pointer": "/data/type",
"detail": "Type must not be null"
}
]
},
{
"data": {
"submission_warning_understood": true,
"customer_reference": "CustomerRef",
"addresses": {
"transferee_address": {
"details": {
"type": "UK",
"uprn": 100040203976,
"organisation_name": null,
"department_name": null,
"sub_building_description": null,
"building_description": "Apartment 11",
"street": "113 Newton Street",
"dependent_street": null,
"dependent_locality": null,
"double_dependent_locality": null,
"post_town": "MANCHESTER",
"postcode": "M1 1AE",
"full_address": "Apartment 11 ,113 Newton Street, MANCHESTER, M1 1AE",
"care_of_name": "SP"
}
}
},
"documents": {
"TR1": {
"document_id": "a40d6fe0-bd45-4c49-b72a-0d80cf43db83",
"type": "TR1",
"document_metadata": {
"certification_statement_type": "CERTIFIED",
"document_filename": "TR1.pdf"
}
},
"Deed": {
"type": "MRTG_DEED",
"document_id": "e10f5369-a623-43fb-aeaa-5e02625e9f83",
"document_metadata": {
"certification_statement_type": "CERTIFIED",
"document_filename": "Deed.pdf"
}
}
},
"parties": {
"Transferee": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "John",
"surname": "Smith"
},
"addresses": "transferee_address",
"representation_type": "LODGING_CONVEYANCER"
},
"Transferor1": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Tony",
"surname": "Bonito"
},
"other_conveyancer": {
"full_name": "ABC Conveyancers",
"registered_address": "13 Coral Close, Tuffley, Gloucester, GL4 0RG",
"conveyancer_reference": "abc-conveyancers-ref"
},
"representation_type": "OTHER_CONVEYANCER"
},
"Transferor2": {
"details": {
"type": "PRIVATE_INDIVIDUAL",
"forenames": "Toni",
"surname": "Bonito"
},
"other_conveyancer": {
"full_name": "ABC Conveyancers",
"registered_address": "13 Coral Close, Tuffley, Gloucester, GL4 0RG",
"conveyancer_reference": "abc-conveyancers-ref"
},
"representation_type": "OTHER_CONVEYANCER"
},
"TheBank": {
"details": {
"type": "UK_COMPANY",
"company_number": "12345",
"organisation_name": "Albion Home Loans Limited"
},
"representation_type": "LODGING_CONVEYANCER"
}
},
"applicants": [
"Transferee"
],
"application_lodger": {
"email": "valid.email@landregistry.gov.uk",
"type": "CONVEYANCER"
},
"titles": {
"MS312531": {
"disclosable_overriding_interests": "false",
"title_number": "MS312531",
"scope_details": {
"scope": "WHOLE",
"part_description": null
}
}
},
"transactions": {
"Transfer": {
"documents": [],
"type": "T",
"priority": 1,
"fee_in_pence": 3000,
"details": {
"type": "TRANSFER",
"title_guarantee_code": "FULL",
"additional_provisions_code": "NO_PROVISIONS",
"consideration_description": "string",
"consideration_type": "MONETARY_VALUE",
"value": 1300000,
"date": "2023-12-12"
},
"party_roles": [
{
"party_reference": "Transferee",
"role": "TRANSFEREE"
},
{
"party_reference": "Transferor1",
"role": "TRANSFEROR"
},
{
"party_reference": "Transferor2",
"role": "TRANSFEROR"
}
],
"title_references": [
"MS312531"
]
},
"Charge": {
"documents": [
"Deed"
],
"type": "C",
"priority": 2,
"fee_in_pence": 3000,
"details": {
"type": "CHARGE",
"date": "2024-01-01",
"mdref": "MD007A"
},
"party_roles": [
{
"party_reference": "Transferee",
"role": "BORROWER"
},
{
"party_reference": "TheBank",
"role": "LENDER"
}
],
"title_references": [
"MS312531"
]
}
},
"type": "REGISTER_UPDATE"
}
},
{
"data": {
"application_request_id": "3be62ad3-c542-452d-975e-6cd18d77196f"
}
}
]
}