How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HM Land Registry Submit an application API

The Submit an application API API from HM Land Registry — 2 operation(s) for submit an application api.

HM Land Registry Submit an application API is one of 18 APIs that HM Land Registry publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Submit an application API. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 2 operations across 2 paths, and defines 57 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://businessgateway.landregistry.gov.uk/bg2/api, https://bgtest.landregistry.gov.uk/bg2test/api.

2 operations 2 paths 57 schemas 2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://landregistry.data.gov.uk/landregistry/query
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

HM Land Registry Submit an application API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 POST. Each is listed below with its method, path, parameters, and response codes.

Submit an application API 2
POST
/v0/applications
Submit an application API - Submit application creation requests for processing
Submit an application API 1 param body → 202400401500
POST
/v1/applications
Submit an application
submit_an_application_to_change_the_register_v1 1 param body → 202400401500

Schemas 57

The contract defines 57 schemas that model the data the API accepts and returns. The most detailed are SubstantiveApplicationData (13 properties), SubstantiveApplicationData_2 (13 properties), Transaction_2 (8 properties), Transaction (8 properties). Each schema is shown below with its type and property counts.

OtherOrganisation
object
A party object to capture infomation about an other organisation
1 required
DxAddress
object
A document exchange address
2 required
PoBoxAddress
object
An address of a PO Box
3 required
OtherConveyancer
object
Information about another conveyancer (who is not the lodging conveyancer) representing a party on the application
3 properties 3 required
TitleDetails
object
Information about a HM Land Registry title
4 properties 4 required
PartyDetails
object
Details of the party that apply to all party types
1 property 1 required
UnknownParty
object
A party object to capture infomation about an unknown party
1 required
Transaction
object
The object representing a transaction to apply to specific titles on the application
8 properties 3 required
AddressForServiceOption
string
PROVIDEDADDRESS - The address for service has been provided alongside this option NOTREQUIRED - The address for service is not required for the party
PartyReference
string
Unique identifier for parties, used to reference parties from elsewhere in the spec
AddressDetails
object
The details captured for a specific address. Details differ depending on type
1 property 1 required
Party
object
A person or entity that has a role in an transaction
7 properties 3 required
DocumentMetadata
object
Metadata about the document that was uploaded
2 properties 2 required
DocumentReference
string
Unique identifier for documents, used to reference documents from elsewhere in the spec
OverseasAddress
object
The address of a premise outside the UK
1 required
TransactionDetails
object
Details of the transaction that apply to all transaction types
1 property 1 required
PrivateIndividual
object
A party object to capture infomation about a private individual
1 required
UKCompany
object
A party object to capture infomation about an UK company
2 required
TitleScopeDetails
object
The scope of the title that is being updated
2 properties 1 required
OverseasCompany
object
A party object to capture infomation about an overseas company
2 required
UkAddress
object
A UK postal address
3 required
BypassValidationData
object
Fields to describe which validators to bypass and why
4 properties 4 required
EmailAddress
object
An object containing the email address of the customer
1 required
ValueBand
object
A range the value of the transaction falls between. Valid bands are: 0 - 100000 100001 - 200000 200001 - 500000 500001 - 1000000 1000001 +
2 properties 1 required
Transfer
object
Details about a transfer transaction
4 required
Address
object
An object containing an address, where the address details may be one of multiple types
1 property 1 required
ApplicationCreationResponse
object
The response from the application submission endpoint
1 property
AmountDetails
object
A type of TransactionDetails that captures the value of the transaction
Charge
object
A TransactionDetails object to capture information about a charge
2 required
SubstantiveApplication
object
The request to submit an application to HM Land Registry
1 property 1 required
ApplicationCreationDataResponse
object
The response wrapper from the application submission request
1 property
SubstantiveApplicationData
object
The data required to capture an application
13 properties 7 required
ProblemDetails
object
Detailed information about an error
3 properties 2 required
ApplicationLodger
object
Information about the person lodging the application (This is usually the conveyancer lodging on behalf of an individual)
3 properties 2 required
Discharge
object
A TransactionDetails object to capture information about a discharge
1 required
AddressReference
string
Unique identifier for addresses, used to reference addresses from elsewhere in the spec
DocumentDetails
object
The details about an uploaded document
4 properties 3 required
PartyRole
object
Information about the roles and capacities for a specific party
3 properties 2 required
ErrorResponse
object
Wrapper for any error responses
7 properties
BfpoAddress
object
A British Forces Post Office address
3 required
PoBoxAddress_2
object
An address of a PO Box
3 required
OtherConveyancer_2
object
Information about another conveyancer (who is not the lodging conveyancer) representing a party on the application
3 properties 3 required
UnknownParty_2
object
A party object to capture infomation about an unknown party
2 required
Transaction_2
object
The object representing a transaction to apply to specific titles on the application
8 properties 3 required
PrivateIndividual_2
object
A party object to capture infomation about a private individual
2 required
UKCompany_2
object
A party object to capture infomation about an UK company
1 required
OverseasCompany_2
object
A party object to capture infomation about an overseas company
4 required
UkAddress_2
object
A UK postal address
3 required
ValueBand_2
object
A range the value of the transaction falls between. Valid bands are: 0 - 100000 100001 - 200000 200001 - 500000 500001 - 1000000 1000001 +
2 properties 1 required
Transfer_2
object
Details about a transfer transaction
4 required
SubstantiveApplicationData_2
object
The data required to capture an application
13 properties 6 required
ValidationDisagreement
object
Fields to describe which validation results are contested and why
4 properties 4 required
ProblemDetails_2
object
Detailed information about an error
3 properties 2 required
ApplicationLodger_2
object
Information about the person lodging the application (This is usually the conveyancer lodging on behalf of an individual)
3 properties 2 required
AddressReference_2
string
Unique identifier for addresses, used to reference addresses from elsewhere in the spec
DocumentDetails_2
object
The details about an uploaded document
4 properties 3 required
PartyRole_2
object
Information about the roles and capacities for a specific party
4 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hm-land-registry-submit-an-application-api-api-openapi.yml Raw ↑

Other APIs HM Land Registry publishes across the network.

HM Land Registry Open Data SPARQL API
HM Land Registry Price Paid Data Linked Data API
UK House Price Index Linked Data API
HM Land Registry Application information API
HM Land Registry Attach a document API
HM Land Registry Attach a message API
HM Land Registry Datasets API
HM Land Registry Download a document API
HM Land Registry Draft Titles API
HM Land Registry ECD API
HM Land Registry Notifications API
HM Land Registry Official Copies API
Where this information came from

This is an independent, third-party profile of HM Land Registry Submit an application API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.